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Advance Praise for Head First Programming 


“Head First Programming does a great job teaching programming using an iterative process. Add a little, 
explain a little, make the program a little better. This is how programming works in the real world 
and Head First Programming makes use of that in a teaching forum. I recommend this book to anyone 
who wants to start dabbling in programming but doesn’t know where to start. I’d also recommend this 
book to anyone not necessarily new to programming, but curious about Python. It’s a great intro to 
programming in general and programming Python specifically.” 

—JeremyJones, Coauthor of Python for Unix and Linux System Administration 


“David Griffiths and Paul Barry have crafted the latest gem in the Head First series. Do you use a 
computer, but are tired of always using someone else’s Software? Is there something you wish your 
computer would do but wasn’t programmed for? In Head First Programming , you’11 learn how to write 
code and make your computer do things your way.” 

— Bili Mietelski, Software Engineer 


“Head First Programming provides a unique approach to a complex subject. The early chapters make 
excellent use of metaphors to introduce basic programming concepts used as a foundation for the rest 
of the book. This book has everything, from web development to graphical user interfaces and game 
programming.” 

— Doug Hellmann, Senior Software Engineer, Racemi 


“A good introduction to programming using one of the best languages around, Head First Programming 
uses a unique combination of visuals, puzzles, and exercises to teach programming in a way that is 
approachable and fun.” 

— Ted Leung, Principal Software Engineer, Sun Microsystems 


Praise for other Head First books 


“Kathy and Berf s Head First Java transforms the printed page into the closest thing to a GUI youVe ever 
seen. In a wry, hip manner, the authors make learningjava an engaging ‘whaf re they gonna do next?’ 
experience.” 

— Warren Keuffel, Software Development Magazine 


“Beyond the engaging style that drags you forward from know-nothing into exalted Java warrior status, Head 
First Java covers a huge amount of practical matters that other texts leave as the dreaded ‘exercise for the 
reader.... 5 Ifs elever, wry, hip and practical—there aren’t a lot of textbooks that can make that claim and live 
up to it while also teaching you about object serialization and network launch protocols.” 

— Dr. Dan Russell, Director of User Sciences and Experience Research 
IBM Almaden Research Center (and teaches Arti fici al Intelligence at 
Stanford University) 


“Ifs fast, irreverent, fun, and engaging Be careful—you might actually learn something!” 

— Ken Arnold, former Senior Engineer at Sun Microsystems 

Coauthor (with James Gosling, creator of Java), The Java Programming 
Language 


“I feel like a thousand pounds of books have just been lifted off of my head.” 

— Ward Cunningham, inventor of the Wiki and founder of the Hillside Group 


4 Just the right tone for the geeked-out, casual-cool guru coder in all of us. The right reference for practi¬ 
cal development strategies—gets my brain going without having to slog through a bunch of tired, stale 
professor-speak. ” 

— Travis Kalanick, Founder of Scour and Red Swoosh 
Member of the MIT TR100 

“There are books you buy, books you keep, books you keep on your desk, and thanks to CfReilly and the 
Head First crew, there is the penultimate category, Head First books. They’re the ones that are dog-eared, 
mangled, and carried everywhere. Head First SQL is at the top of my stack. Heck, even the PDF I have 
for review is tattered and torn.” 

— Bili Sawyer, ATG Curriculum Manager, Oracle 


“This book’s admirable clarity, humor and substantial doses of elever make it the sort of book that helps 
even non-programmers think well about problem-solving.” 

— Cory Doctorow, co-editor of Boing Boing 
Author, Dozvn and Out in the Magic Kingdom 
and Someone Comes to Town , Someone Leaves Town 
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“I received the book yesterday and started to read it... and I coukkft stop. This is definitely tres ‘cool.’ It 
is fun, but they cover a lot of ground and they are right to the point. I’m really impressed.” 

— Erich Gamma, IBM Distinguished Engineer, and co-author of Design Patterns 

“One of the funniest and smartest books on Software design I’ve ever read.” 

— Aaron LaBerge, VP Technology, ESPN.com 


“What used to be a long trial and error learning process has now been reduced neatly into an engaging 
paperback.” 

— Mike Davidson, CEO, Newsvine, Inc. 


“Elegant design is at the core of every chapter here, each concept conveyed with equal doses of 
pragmatism and wit.” 

— Ken Goldstein, Executive Vice President, Disney Online 

“I V Head First HTML with CSS & XHTML —it teaches you everything you need to learn in a ‘fun coated’ 
format.” 

— Sally Applin, UI Designer and Artist 


“Usually when reading through a book or article on design patterns, I’d have to occasionally stick myself 
in the eye with something just to make sure I was paying attention. Not with this book. Odd as it may 
sound, this book makes learning about design patterns fun. 

“While other books on design patterns are saying ‘Buehler... Buehler... Buehler...’ this book is on the 
float belting out ‘Shake it up, babyf” 

— Eric Wuehler 


“I literally love this book. In fact, I kissed this book in front of my wife. 
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— Satish Kumar 
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We dedicate this book to the first person who looked at a computer 
and then asked the question, “I wonder how I make it do this... ?” 


And to those that made programming complex enough that people 
need a book like ours to learn it. 


David: To Dawn. The smartest person I know. 

Paul: This one’s dedicated to my father, Jim Barry, who, 25 years 
ago—when I needed a push—pushed me toward computing. That 
was a good push. 
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Paul Barry recently worked out that he has 
been programming for close to a quarter century, a 
fact that came as a bit of a shock. In that time, Paul 
has programmed in lots of different programming 
languages, lived and worked in two countries on two 
continents, got married, had three kids (well... his wife 
Deirdre actually had them , but Paul did play his part), 
completed a B.Sc. and M.Sc. in Computing, written 
two other books, written a bunch of technical articles 
for Linux Journal , and managed not to lose his hair... a 
situation that, sadly, may in fact be changing. 


When Paul first saw Head First HTML with CSS & 
XHTML , he loved it so much he knew immediately that 
the Head First approach would be a great way to teach 
programming. He is only too delighted, together with 
David, to create this book in an attempt to prove his 
hunch correct. 


Paufs day job is working as a lecturer at The Institute 
of Technology, Garlow in Ireland. As part of the 
Department of Computing & Networking, Paul gets 
to spend his day exploring, learning, and teaching 
cool programming technologies, which is his idea of 
fun (and further proof that Paul probably needs to get 
out more). Paul hopes his students think the stuff he 
teaches is fun, too. 



David Griffiths began programming at age 12, 
when he saw a documentary on the work of Seymour 
Papert. At age 15, he wrote an implementation of 
PaperPs computer language LOGO. After studying 
Pure Mathematics at University, he began writing code 
for computers and magazine articles for humans. He’s 
worked as an agile coach, a developer, and a garage 
attendant, but not in that order. He can write code in 
over 10 languages and prose in just one, and when not 
writing, coding, or coaching, he spends much of his 
spare time travelling with his lovely wife—and fellow 
Head First author—Dawn. 

Before writing Head First Programming , he wrote another 
book called Head First Rails , which is an excellent read 
and would make a thoughtful gift for any close friend or 
family member. 

You can follow him on Twitter at: 

http://twitter.com/dgriffiths 
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stflrting -fco code 

Finding your way 

Writing programs gives you the power to control your PC. 

Almost everyone knows how to use a computer, but few people take the next step and 
learn how to control it. If you use other people’s Software, you will always be limited by 
what other people think you want to do. Write your own programs and the only limit will 
be your own imagination. Programming will make you more Creative, it will make you 
think more precisely, and it will teach you to analyze and solve problems logically. 

Do you want to be programmed or be the programmer? 
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textual data 

Every string has its place 

Imagine trying to communicate without words. 

AII programs process data, and one of the most important types of data is text. In this 
chapter, you’ll work through the basies of textual data. You’ll automatically search 
text and get back exactly what you’re looking for. Along the way, you’ll pick up key 
programming concepts such as methods and how you can use them to bend your 
data to your will. And finally, you’ll instantly power up your programs with the help of 
library code. 
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junctioris 

Let's get organized 

As programs grow, the code often becomes more complex. 

And complex code can be hard to read, and even harder to maintain. One way of 
managing this complexity is to create functions. Functions are snippets of code 
that you use as needed from within your program. They allow you to separate out 
common actions, and this means that they make your code easier to read and 
easier to maintain. In this chapter, you’ll discover how a little function knowledge 
can make your coding life a whole lot easier. 
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datn files and arrays 

Sort it out 

As your programs develop, so do your data handling needs. 

And when you have lots of data to work with, using an individual variable for each piece 
of data gets really old, really quickly. So programmers employ some rather awesome 
containers (known as data structures) to help them work with lots of data. More times 
than not, all that data comes from a file stored on a hard disk. So, how can you work 
with data in your files? Turns out it’s a breeze. 
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Surf’s up in Codeville 114 

Find the highest score in the results file 115 

Iterate through the file with the open, for, close pattern 116 

The file contains more than numbers... 120 

Split each line as you read it 121 

The split() method cuts the string 122 

But you need more than one top score 126 

Keeping track of 3 scores makes the code more complex 127 

An ordered list makes code much simpler 128 

Sorting is easier in memory 129 

You can’t use a separate variable for each line of data 130 

An array lets you manage a whole train of data 131 

Python gives you arrays with lists 132 

Sort the array before displaying the results 136 

Sort the scores from highest to lowest 139 

And the winner is...? 142 

You somehow forgot the surfer names 143 

Your Programming Toolbox 144 


table of contents 



heislies and databases 

Putting data in its place 

Arrays arerTt the only show in town when it comes to data. 

Programming languages come with other data-arranging goodies too, and our 
chosen tool, Python, is no exception. In this chapter, you’ll associate values 
with names using a data structure commonly called the hash (better known as 
dictionary to Python-folk). And when it comes to working with stored data, you’ll 
read data from an extemal database system as well as from regular text-based 
files. AII the world’s awash with data, so turn the page and start applying your ever- 
expanding programming skills to some cool data-processing tasks. 
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modular programming 

Keeping things straight 

The code thatyou write will make its way into many programs. 

And, although sharing is good, you need to be careful. One programmer might take 
your code and use it in an unexpected way, while another might change it without even 
letting you know. You might want to use one function in all your programs and, over 
time, that function’s code might change to suit your needs. Smart programmers take 
advantage of modular programming techniques to keep their workload manageable. 
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building a graphical user interface 

Going ali gooey 

Vour coding skills are great and getting better all the time. 

It’s just a shame your programs are not that nice to look at. Displaying prompts 
and messages on a text-based console is all well and good, but it’s so 1970s, 
isn’t it? Add some green text on a black background and your retro look will be 
complete. There has to be a better way to communicate with your users than 
the console, and there is: using a graphical user interface or GUI (pronounced 
“gooey”). Sounds cool, but complex, and it can be. But, don’t fret; learning a trick or 
two will have your code all graphical in no time. Let’s get all gooey (sorry, GUI) in 
this chapter. 
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gu!s and data 

Data entry widgets 

GUls don’t just process events. They also handle data. 

Almost all GUI applications need to read user data, and choosing the right widgets can 
change your interface from data entry helllo user heaven. Widgets can accept plain 
text, or just present a menu of options. There are lots of different widgets out there, 
which means there are lots of choices, too. And, of course, making the right choice can 
make all the difference. It’s time to take your GUI program to the next level. 
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exceptions anc[ message boxes 

Get the message? 

Sometimes things just go wrong. You just need to handle it. 

There will always be things beyond your control. Networks will fail. Files will 
disappear. Smart coders learn how to deal with those kinds of errors and make 
their programs recover gracefully. The best Software keeps the user informed 
about the bad things that happen and what should be done to recover. By learning 
how to use exceptions and message boxes, you can take your Software to the 
next level of reliability and quality. 
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gtapfiioctl Interface elements 

Selecting the right tool 

lt’s easy to make your programs more effective for your users. 

And when it comes to GUI applications, there’s a world of difference between a working 
interface and one that’s both useful and effective. Selecting the right tool for the 
right job is a skill that comes with experience, and the best way to get that experience 
is to use the tools available to you. In this chapter, you’11 continue to expand your 
GUI application building skills. There’s a bunch of truly useful widgets waiting to be 
experienced. So, turn the page and let’s get going. 
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custotn widgets and classes 

With an object in mind 

Requirements can be complex, but programs don’t have 
to be. 

By using object orientation, you can give your programs great power without 
writing lots of extra code. Keep reading, and you’11 create custom widgets that do 
exactly what you want and give you the power to take your programming skills 
to the next level. 
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The Top Ten Things (we didrTt cover) 



YoiTve come a long way. 

But learning how to program is an activity that never stops. The more you code, the 
more you’ll need to learn new ways to do certain things. YoiTII need to master new 
tools and new techniques, too. There’s just not enough room in this book to show you 
everything you might possibly need to know. So, here’s our list of the top ten things we 
didn’t cover that you might want to learn more about next. 
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Who is this book for? 

If you can answer “yes” to ali of these: 


o 

e 
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Do you wish you had the know-how to control your 
computer and make it do new things? 

Do you want to learn how to program, so you can create 
the next big thing in Software, make a small fortune, and 
retire to your own private island? 

Do you prefer actually doing things and applying the stuff 
you learn over listening to someone in a lecture rattle on 
for hours on end? 
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•fav—fetthed- M, Y°“ 
stavt somewbevei 


this book is for you. 


Who should probably back away frow this book? 

If you can answer “yes” to any of these: 


o 

o 

o 


Are you a seasoned programmer? Do you already know 
how to program? 

Are you looking for a quick introduction or reference book 
to Python? 

Would you rather have your toenails pulled out by 15 
screaming monkeys than learn something new? Do you 
believe a programming book should cover everything and 
if it bores the reader to tears in the process then so much 
the better? 


this book is not for you. 
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We know what youVe thinking 


“How can this be a serious Programming book?” 

“What’s with ali the graphics?” 

“Can I actually leam it this way?” 

We know what your brain is thinkmg 

Your brain craves novelty. It’s always searching, scanning, waiting for something 
unusual. It was built that way, and it helps you stay alive. 

So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with the 
brain’s real ]oh —recording things that matter. It doesn’t bother saving the 
boring things; they never make it past the “this is obviously not important’' 
filter. 


& Uhj. 


THIS is i 




How does your brain know what’s important? Suppose you’re out for a day 
hike and a tiger jumps in front of you, what happens inside your head and 
body? 

Neurons fire. Emotions crank up. Chemicals surge. 

And that’s how your brain knows... 

This must be important! Don't forget it! 

But imagine you’re at horne, or in a library. It’s a safe, warm, tiger-free zone. 

You’re studying. Getting ready for an exam. Or trying to learn some tough T\\\S ' sy> 
technical topic your boss thinks will take a week, ten days at the most. 

Just one problem. Your brain’s trying to do you a big favor. It’s trying to 
make sure that this obviously non-important content doesn’t clutter up scarce 
resources. Resources that are better spent storing the really big things. 

Like tigers. Like the danger of fire. Like how you should never have 
posted those “party” photos on your Facebook page. And there’s no 
simple way to teli your brain, “Hey brain, thank you very much, but 
no matter how dull this book is, and how little I’m registering on the 
emotional Richter scale right now, I really do want you to keep this 
stuff around.” 
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Metacognition: tbinking about tbinking 

If you really want to learn, and you want to learn more quickly and more 
deeply, pay attention to how you pay attention. Think about how you think. 

Learn how you learn. 

Most of us did not take courses on metacognition or learning theory when we 
were growing up. We were expected to learn, but rarely taught to learn. 

But we assume that if you’re holding this book, you really want to learn how 
to program And you probably don’t want to spend a lot of time. If you want 
to use what you read in this book, you need to remember what you read. And 
for that, you Ve got to understand it. To get the most from this book, or any book 
or learning experience, take responsibility for your brain. Your brain on this 
content. 

The trick is to get your brain to see the new material you’re learning as 
Really Important. Grucial to your well-being. As important as a tiger. 

Otherwise, you’re in for a constant battle, with your brain doing its best to 
keep the new content from sticking. 

So just how DO you get your brain to treat 
programming like it was a hungry tiger? 

There’s the slow, tedious way, or the faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are able to learn 
and remember even the dullest of topics if you keep pounding the same thing into your 
brain. With enough repetition, your brain says, “This doesn’t feel important to him, but he 
keeps looking at the same thing over and over and over , so I suppose it must be.” 



The faster way is to do any thing that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and theyVe ali things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 


A conversational style helps because people tend to pay more attention when they 
perceive that theyVe in a conversation, since theyVe expected to follow along and hold up 
their end. The amazing thing is, your brain doesnV necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 


But pictures and conversational style are just the beginning... 
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Here'$ what WE did: 

We used pictures , because your brain is tuned for visuals, not text. As far as your brairfs 
concerned, a picture really is worth a thousand words. And when text and pictures work 
together, we embedded the text in the pictures because your brain works more effectively 
when the text is within the thing the text refers to, as opposed to in a caption or buried in the 
text somewhere. 

We used redundancy , saying the same thing in different ways and with different media types, 
and multiple senses , to increase the chance that the content gets coded into more than one area 
of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for novelty, 
and we used pictures and ideas with at least some emotional content , because your brain 
is tuned to pay attention to the biochemistry of emotions. That which causes you to feel 
something is more likely to be remembered, even if that feeling is nothing more than a little 

humor , surprise , or interest. 

We used a personalized, conversational style , because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you’re reading. 

We included more than 80 activities , because your brain is tuned to learn and remember 
more when you do things than when you read about things. And we made the exercises 
challenging-yet-do-able, because that’s what most people prefer. 

We used multiple learning styles , because you might prefer step-by-step procedures, while 
someone else wants to understand the big picture first, and someone else just wants to see 
an example. But regardless of your own learning preference, everyone benefits from seeing the 
same content represented in multiple ways. 

We include content for both sides of your brain , because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can stay focused. 
Since working one side of the brain often means giving the other side a chance to rest, you 
can be more productive at learning for a longer period of time. 

And we included stories and exercises that present more than one point of viezv, 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 

We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work at 
something. Think about it—you can’t get your body in shape just by watching people at the 
gym. But we did our best to make sure that when you’re working hard, it’s on the right things. 
That you We not spending one extra dendrite processing a hard-to-understand example, 
or parsing difficult, jargon-laden, or overly terse text. 

We used people. In stories, examples, pictures, etc., because, well, because youPe a person. 
And your brain pays more attention to people than it does to things. 
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Heres what YOU can do to bend 
your brain into submission 

So, we did our part. The rest is up to you. These tips are a 
starting point; listen to your brain and figure out what works 
for you and what doesfft. Try new things. 

Cu-fc this out dhd stidk it 

otn youir ire-frigera-tov. 


O Slow down. The more you understand, the 
less you have to memorize. 

Dofft just read. Stop and think. When the book asks 
you a question, dofft just skip to the answer. Imagine 
that someone really is asking the question. The 
more deeply you force your brain to think, the better 
chance you have of learning and remembering. 

Do the exercises. Write your own notes. 

We put them in, but if we did them for you, that 
would be like having someone else do your workouts 
for you. And dofft just look at the exercises. Use a 
pencil. There’s plenty of evidence that physical 
activity while learning can increase the learning. 

o Read the 'There are No Dumb Questions" 

That means all of them. They’re not optional 
sidebars, they We part of the core content! 

Dofft skip them. 

Make this the last thing you read before bed. 
Or at least the last challenging thing. 

Part of the learning (especially the transfer to 
long-term memory) happens after you put the book 
down. Your brain needs time on its own, to do more 
processing. If you put in something new during that 
Processing time, some of what you just learned will 
be lost. 

Talk about it. Out loud. 

Speaking activates a different part of the brain. If 
yoffre trying to understand something, or increase 
your chance of remembering it later, say it out loud. 
Better stili, try to explain it out loud to someone else. 
Yoffll learn more quickly, and you might uncover 
ideas you hadfft known were there when you were 
reading about it. 


o Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 

o Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s time 
for a break. Once you go past a certain point, you 
wofft learn faster by trying to shove more in, and 
you might even hurt the process. 

o Feel something. 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke 
is stili better than feeling nothing at all. 

Write a lot of code! 

There’s only one way to learn to program: writing 
a lot of code. And that’s what yoffre going to 
do throughout this book. Goding is a skill, and the 
only way to get good at it is to practice. We’re going 
to give you a lot of practice: every chapter has 
exercises that pose a problem for you to solve. Dofft 
just skip over them—a lot of the learning happens 
when you solve the exercises. We included a solution 
to each exercise—dofft be afraid to peek at the 
solution if you get stuck! (It’s easy to get snagged 
on something small.) But try to solve the problem 
before you look at the solution. And definitely get it 
working before you move on to the next part of the 
book. 
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how to use this book 


Read Me 

This is a learning experience, not a reference book. We deliberately stripped out everything 
that might get in the way of learning whatever it is we’re working on at that point in the 
book. And the first time through, you need to begin at the beginning, because the book 
makes assumptions about what you Ve already seen and learned. 


This is not Head First Python. 

We use release 3 of the Python programming language throughout this book, but this 
fact alone does not make this book Head First Python. We chose Python because it’s a great 
programming language to start with and it’s also a great programming language to grow 
with. In fact, Python might be the only programming language you’11 ever need to learn 
and use (although your employer might think otherwise). Of course, you have to start with 
something, and we can think of no better programming language to use than Python when 
first learning how to program. That said, this book isn’t designed to teach you Python; 
it’s designed to teach you programming , so most of the things we show you are designed to 
hightlight the programming concept , not the Python feature. 


You need to install Python 3 on your computer. 


To run the programs in this book, you need to download and install Python 3 on your 
computer. This isn’t as hard as it sounds. Pop on over to the Python download site and 
select the option that fits b est with the computer you are using. Just b e sure to select release 
3 of Python, not release 2: http: //vuvuvu.python.org/dozvnloac /| . 


We begin by teaching some basic programming concepts, then we 
start putting programming to work for you right away. 

We cover the fundamentals of programming in Ghapter 1. That way, by the time you 
make it all the way to Ghapter 2, you are creating programs that actually do something 
real, useful, and—gulp!—fun. We are guessing you’11 be amazed by how much you can do 
with less than a dozen lines of code in Ghapter 2. The rest of the book then builds on your 
programming skills turning you from programming newbie to coding ninja master in no time. 
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The activities are NOT optional. 

The exercises and acdvities are not add-ons; they’re part of the core content of the book. 
Some of them are to help with memory, some are for understanding, and some will help 
you apply what youVe learned. Don y t skip the exercises. 


The redundancy is intentional and important. 

One distinet difference in a Head First book is that we want you to really get it. And we 
want you to finish the book remembering what youVe learned. Most reference books 
don’t have retention and recall as a goal, but this book is about leorning , so you’11 see some 
of the same concepts come up more than once. 


The examples are as lean as possible. 

Our readers teli us that it’s frustrating to wade through 200 lines of an example looking 
for the two lines they need to understand. Most examples in this book are shown within 
the smallest possible context, so that the part you’re trying to learn is ciear and simple. 
Don’t expect all of the examples to be robust, or even complete—they are written 
specifically for learning, and aren’t always fully-functional. 

WeVe placed a lot of the code examples on the Web so you can copy and paste them as 
needed. You’11 find them at two locations: 


http:/ / www.headfirstlabs.com/books/hfprog/| and 


http://programming.itcarlow.ie 


The Brain Power exercises don't have answers. 

For some of them, there is no right answer, and for others, part of the learning 
experience of the Brain Power activities is for you to decide if and when your answers 
are right. In some of the Brain Power exercises, you will find hints to point you in the 
right direction. 





the review team 


The technical review team 
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Technical Reviewers: 

Doug Hellmann is a Senior Software Engineer 
at Racemi and former Editor in Chief for Python 
Magazine. He has been programming in Python since 
version 1.4 and prior to Python worked mostly with G 
on a variety of Unix and non-Unix platforms. He has 
worked on projects ranging from mapping to medical 
news publishing, with a little banking thrown in for 
good measure. Doug spends his spare time working on 
several open source projects; reading Science fiction, 
history, and biographies; and writing the Python Module 
of the Week blog series. 

Jeremy Jones is the coauthor of Python for Unix and 
Linux System Administration and has been actively using 
Python since 2001. He has been a developer, system 
administrator, quality assurance engineer, and tech 
support analyst. They ali have their rewards and 
challenges, but his most challenging and rewarding job 
has been husband and father. 


Ted Lcu«5 




Bili Afietelski 


Ted Leung has been programming in Python since 
2002 and is currently a Principal Software Engineer 
at Sun Microsystems. He has a Bachelor of Science 
degree in Mathematics from the Massachusetts Institute 
of Technology and a Master’s of Science degree in 
computer Science from Brown University. Ted’s weblog 
is available at http://www.sauria.com/blog 

Bili Mietelski has been an Information Technology 
geek for over 20 years. He’s currently a Software 
Engineer at a leading national academic medical center 
in the Ghicagoland area, working on statistical research 
studies. When he’s not at the office or tied to a computer, 
you’11 find him at a golf course chasing a little white ball. 
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safari books Online 


Safari® Pooks Online 


Safari* 

Books Online 


When you see a Safari® icon on the cover of your favorite 
technology book that means the book is available online 
through the 0’Reilly Network Safari Bookshelf. 


Safari offers a solution that’s better than e-books. It’s a virtual library that lets you 
easily search thousands of top tech books, cut and paste code samples, download 
chapters, and hnd quick answers when you need the most accurate, current 
information. Try it for free at http : / / safari . oreilly . com. 
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Finding your way 



I wish "sweet cheeks" here 
would finish with the polishing 
I've got to re-bore the cam 
shaf t and reprogram the EMS 
for Saturdays drift race. 


Writing programs gives you the power to control your PC. 

Almost everyone knows how to use a computer, but few people take the next step and 
learn how to control it. If you use other people’s Software, you will always be limited by 
what other people think you want to do. Write your own programs and the only limit will be 
your own imagination. Programming will make you more Creative, it will make you think 
more precisely, and it will teach you to analyze and solve problems logically. 

Do you want to be programmed or be the programmer? 


this is a new chapter 




take control ofyour computer 


Programmiwg lets you do more 


You Ve got problems to solve and work to do, but your existing Software 
doesn’t quite cut it. Even with all those programs on your computer, 
you stili need to do something different, something specific to you. 


O 


0 



You want to do more with your computer. You want to take control 

Learning to program gives you the power to create and solve. 
Learning to program puts you in charge. 

But, how does programming work? 

Let's look at a simple game written in Python. 
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starting to code 


EL r / r 



This code is a guessing-game program. Study it carefully, and 
opposite each line of code in the program, write down what you 
think the code does. If you're not sure what a particular line of 
code does, dorit worry, but try to guess anyway. One line has 
already been entered to get you started: 


print("Welcome!") 
g = input ("Guess the number: ") 

guess = int(g) r)l/rv 'l D ?.' r : 

if guess == 5: 

print ( "You win!") 


else: 


print ("You lose!") 
print("Game over!") 


This Code is wvi iie n m 

3 of i, e PyoL 
P^arpi^ '^guage, whidh 

' S USed 'thlroughout this book. 
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guessing games 



Solutiori 


print("Welcome!") 
g = input("Guess the number: 
guess = int(g) 
if guess == 5: 

print("You win!") 
else: 

print("You lose!") 
print("Game over!") 


This code is a guessing-game program. You were to write down 
what you think the code does. 


wonp, ,f y 0 uv- a«swe« a* 

tom ou«. |f they ar e 
simila^ the* ewyth m g is 


Pisplay. .a weldome rncssagc : 


/\sk /the usey*. to input ?! ^ucss. 
Cohycirt the mfut to a ny^bpr. 


1/Vas the guessed number e«\ual to 5? 
Teli the usev U y® u win!” 


Othev-wise... 


;.,tell. the user u you Jose( w 


Ehd the .proyam. 


Put what are g and guess ? 

You might be wondering what g and guess are in the code. They are 
called variables and they’re used to keep track of data in the computehs 
memory. 



r V* e . va,ue '»ie*-ed wi II 

I oe khowh as w j" 

g = input("Guess the number: 


guess = int(g) 


Y 


-fi • a v\W*V)CV- 

Tk ' J tt* ,-«*■< ** 

\iecs\or\ O* vnc ^ 

. tt J' 




A variable is really just a label for data. So if the user inputs “3” at the 
keyboard, then guess will be set to the number 3, and whenever the 
computer reads guess, it will read it as the value 3. 



Be careful with 
= signs in code. 


Wafch if r Programming 
watvii 11 * languages use = 

signs for different 

purposes. In most languages 

(including Python), a double 

equals (==) is a test for equality. 

It means, “are these two things 

equal?” In contrast, a single 

equa! (=) is an instruction 

(known as assignment) that 

means “set the value to. ” 
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starting to code 


So how do you rim your code? 

There are two things that you will need to run the guessing-game 
program: an editor and an interpreter. 

The editor saves the code you write into a file on your hard disk. The 
code (sometimes called the source code) is just text, and it can be 
written and read by humans. 



But computers can’t process text meant for humans^ at least not very well. 
That’s why we need a tool to translate the human-friendly source code 
into the binary ls and Os that computers do understand. That’s what an 
interpreter does. In this book, an interpreter called Python is used. 


Hmmm... looks 
like a guessing 
game... 



A 


Th < Pytho* 

i 

python 




The mtev-yv-etev- tranates 

the te*t of the 
tode mto U*ay that the 


iOO I 
inoJi 
OOI^l! 

Joioru, 




So we need an editor and a Python interpreter. Fortunately, Python 3 
comes with a built-in application called IDLE, which does both jobs and 
more. IDLE enables you to write and edit Python code, it translates this 
code into binary form, and finally, it runs the Python 3 program. Because 
of this, IDLE is known as an Integrated Development Environment. 

Let's see these steps in action. 
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operi the Shell 


Create a new prograw file 

When you first start IDLE, it displays a window called the Python Shell. 
Select the New Window option from the Python Shell File menu, 
which creates a new edit window for you. Input your program code as text 
into this edit window and you’11 be on your way. 


This is |PL-£’s v. 
python SVicU • 



Pythnn Ehcill 





Mle fcfiit “b-h E'I D?b»g OpCions Windows 

17 15 : 15 : 57 ) 


iSyw WiiiUuw 

fltt mi Fi-, 



CUI*N 

Ctili-0 


0| i« ti J^kIijIiv 

Alt+M 

C.\ , 17 . flrawwr 
£flth flrnw^pr 

Alr+c 

£jv^ 

S.iwr A 1 . 

Qlh-5 j 
aii+si 

t.itfr Cu|i^ A 1 . 

All+£h 

hnnl Window 

cni+p 

Oose 

AlL + 14 

fexit 




... 


or “ 1 icsnae j| J " lor norc informat ion t 

TV,e Nex Mndow "«p °^ or ' 

Teates a« edit 




This is an IDLB 
edit window. 



■untitted' 


Fjle Frilit Firmat Run Oph^n>i Windnws 


punt £ " Uc _ CQCTiC ] M J 

y = i nptit. £ ' l sm r:.Li:i5 , "l .t* t : " J 

guese — int{g) 

—= 1: 

print £ " 3fon winI" ) 

i*- ’ Ifil 

prmt £ " ro u Io s e l, - ] 
pr i srt £ 11 LiJST,r nvrr i * J 


rhe Python pv-ogiram is Colon— 
eoded within | DLE's edit 
window. This Colov—Coding 
•s netenned to as "syntax 
hjghlighting." Be sure to entev- 
the Code in BXACTU/ as it 
appears hevc. Voni fc (ora^-i 



Go ahead and open a new IDLE edit 
window and type in the code from page 3. 


This is how |PL-£ looks on our Computer^ Thmjs 
w ight look a little dittenent on yours. Pon t 
wonv-y the IPL-E menu system and IPL-fc s 
behavion should be the same, ne^andless <A wh.Ch 

opcvat»^5 s Y s ^ cm Y ou ^ usm 9* 
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starting to code 


Prepare and nm your code 

The next step is to prepare your program code for execution. To do this, 
select File —> Save from the menu to save your program code to a file. 
Choose an appropriate name for your program. 


1 y° u File •* Save 

/ + ' rorn you ea« save 

y/ y^ «ode ih a -Pile. 


Pyihoh pirogv-ar» 




Python programs are usually saved in files that end with . py, so let’s call 
this program game . py. 

It doesn’t really matter to IDLE which directory you save the file in. Some 
coders like to create special directories for each new programming project. 
But for now, just save the code in some directory that’s easy to remember. 


Clidk the Save butto* to 
«rea-te ahd save the -file. 


Now, let's see what happens when we run the program, 

e 


game. py ■ .'DoeijnnentE/game.py 
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test drive 



To run the program, you need to make sure that the edit window for 
the game . py program code is selected. Each time you run (or rerun) 
the program, you need to click on the IDLE edit window and choose 
the Run Module option from the Run menu. The word module is 
a name that IDLE uses to refer to your program code. 

Here’s what happens when you run the code: 


Whe* you (ruh your todt withi* |DL-E, 

*>y *«sa 9 « appear withi» the Python 
Shell »°t w.thm the edit wi »doJ. 

[ ULb f^atically «akes the shell the 
eurrently selected Wmdow the msta.t 
youv prograr» ru*s. 




Congratulations! The program works. 

Each time you run the code, it displays a “Welcome!” message, 
accepts input from the keyboard, and then telis us whether or not 
we guessed the right answer. That means the program is accepting 
input, it’s processing the data, and then it generates output. 


8 Chapter 1 




















starting to code 


O: l've never heard of Python. Is it 
popular? 


Python is used in lots of cool places. 
Google, Industrial Light& Magic, YouTube, 
and NASA (to name a few) ali use Python. 
We think they know what they're doing. 


So, when l'm done with this 
book NI throw Python away and use 
something else, like C#or J ava? 


Only ifyou wantto. Python mightbe 
the only programming language youll ever 
need. But, yes, ifyou wantto leam another 
programming language, you can take 
everything you leam about programming in 
this book and apply itto any other language 
with the minimum of effort. 


Q. Buta buddyof minetold mei 
should learn JavaorC#. Whyareyou 
not using either of these programming 
languages in this book? 


Both J ava and C#are great 
programming technologies, but they can be 
difficult to learn, especially when you are 
just starting out. This is not the case with 
Python. And, anyway, this is a book that's 
designed to teach you how to program, and 
using Python as yourfirst programming 
language will help us to do just that. 


Q. There seems to be many different 
versions of Python. Which should I use? 


There are two main releases of 
Python: 2 and 3. This book is based on 
release 3 of the language. Python 3 is the 
future of the language; any new features 
are guaranteed to be added to release 3 
ofthe language, notrelease 2. Ofcourse, 
like all releases, Python 3 remains a free 
download, which makes ita no-brainer 
when decidiing ifyou can afford to use it. 


tWeictre no 

Dumb Qiiebwns 


hL- Will Python run on my phone, just 
like^ ava? 

That really depends on your phone. 
Python is designed to run on lots of 
different technologies and operating 
Systems. Running your own code on your 
own phone is a very specific requirement, 
and J ava has that pretty well covered at 
the moment. As a programming technology, 
J ava was initially designed to run on very 
small devices, so it is no big surprise that 
it is a strong and popular choice when it 
comes to telephony. 



Why is the Python IDE called 


lt's partly because itsounds like IDE, 
but we suspect that it has more to do with 
Eric Idle, one ofthe founding members of 
the Monty Python's Flying Circus comedy 
group. 


Q, Comeagain?!? MontyPython's 
Flying what? 


Circus. Yes, we know: sounds silly, 
doesn't it? And, believe us, it is. It's funny, 
too. The creator of Python, Guido van 
Rossum, is a big Monthy Python fan and 
reportedly watched the show's reruns 
while he designed Python. Youll find lots 
of references to Monty Python folklore in 
the Python community. Dead parrots are a 
particularfavorite. 



Whatdoes int(g) mean? 


It telis Python to interpretthe user's 
inputas a number ratherthan a letter. 

Within programming languages, the number 
5 is different than the letter'5'. 



So what if we'd left it out? 


The computer would have treated the 
inputentered by the userofthe program as 
a letter. If you ask the computer if a letter 
is equal to a number, itgets confused and 
telis you itisn't. 



Why's that? 


Because if the computer thinks that 
two pieces of information are of different 
"types," it assumes that there's no way they 
can be equal. 


So what if I had nottyped a 
number when I was asked for a guess? 
What if l'd just entered my name or 
something? 


The code would have crashed with an 
error. In fact, Python will complain that the 
program crashed with a 'ValueError" (more 
on these error messages later in the book). 


you are here ► 
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give a hint 


O 


0*t <£ 7 ouV " uSCV " s 



I don't get it. How am I 
supposed to guess the winning 
number? AII the program telis 
me is that my guess is right or 
wrong. Come on, give me some 
help here! 


The program needs to do more. 

At the moment, the guessing game telis the user whether his 
guess is right or wrong, but nothing more than that. It might 
be more helpful if the program displayed more informative 
messages, such as whether the guess is higher or lower than 
the correct answer. That would help the user to hone in on the 
right answer the next time the program is run. 

We can do this by changing the code. But in what way? 


VVc *eed tWis proy-ai* 

{x> display wxessa^es that 

3VC w*OV*C l^O^w^at^C' 



gama.py ■ /D«uments.'gamfl. py 


Die Ldit ["armat Bun flptions Windows 


print £ " lue i cor.e 1" ) 

cj es i n^Jii t. £ Ilie-; eieuzIike : 

quess — int{q] 

f ^ i 

print( "Tou wini"] 


print £ "You losel ■ > 
print ( "Guiie over :" ) 
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starting to code 


r %iharpen your pencil 


You need to decide what messages should be displayed to the 
user. Below is a table showing some typical values the user might 
enter. What do you think the message should say? 


Program Modification 






Think about the original code. You will need to use 
more than just print () commands to provide 
more informative feedback. What else will you 
need? 
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code is a highway 


r fcijiarpen your pencil 



You needed to decide what messages should be displayed to the 
user. Below is a table showing some typical values the user might 
enter. What did you think the message should say? 



A program is more than a list of commands 



You could create a program that was simply a list of commands. But you 
almost never will. This is because a simple list of commands can only be 
run in one direction. It’s just like driving down a straight piece of road: 
there’s really only one way of doing it. 


print 
( "Howdy!") 


w, *d i^o 
at y° u ve ahneady s « h . 


print 
("Come 
again!") 


But programs need to be much smarter than that. 
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starting to code 


Codeville: Your program is like a nciwork 
of roads 

Programs need to do different things under different circumstances. In 
the game, the code displays “You win!” if the user guesses the number 
correctly, and “You lose!” if not. This means that all programs, even really 
simple programs, typically have multiple paths through them. 



Thcirc a\rc r*ahy iroads (oY 
paths) through the tode 


A path refers to the set of instructions that the computer will actually 
follow (or execute). Your code is like a Street network, with lots of sections 
of code connected together just like the streets in a city. When you drive 
through a city, you make decisions as to which streets you drive down by 
turning left or right at different intersections. It’s the same for a program. 
It also needs to make decisions from time to time as to which path to take, 
but for your code, it is not like driving along a road, ifs executing a particular 
path. 


\Y\ 

pvoya** -that av-e like 
mtevsedtions. 


oh the path" 

-fchtrough t( 


Let's look in more detail at how a program decides 
which path to take. 
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fork in the road 


Prawches a re code mtersectiows 


Driving down a Street is easy. You need to make a decision only when 
you get to an intersection. It’s the same for your program. When a 
program has a list of commands, it can blindly execute them one after 
another. But sometimes, your program needs to make a decision. Does 
it run this piece of code or that piece of code? 



These decision points are called branches, and they are the road 
intersections in your code. 


Bv-anfches ave 


like voad 


Your program makes a decision using a branch condition. A branch 
condition has the value true or false. If the branch condition is true, it 
runs the code on the true branch. And if the branch condition is false, it 
runs the code on the false branch. 


Tke eoroPuftev will *bake “this paih “the 



r 




The £ 0 «,p ^ wi „ ^ hjs 


1 

The talse path. 
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starting to code 


if/else brawches 

WeVe already seen a branch in the Python game program: 





guess==5? 


if guess == 5: 

print ( "You win!") 
else: 

print ( "You lose!") 
print("Game over!") 

Python, like many languages, has if/else branches. In our example, 
the branch condition is the if guess == 5 piece of code. This is a 
test for equality and it will resuit in the value true or false. 

The code on the true path is indented, and given after the if line. The 
code on the false path is indented, and given after the else line: 

These tommaKds «rt* «jj( 
it they ave the ?ath U 
4-u» Dvoftva» takes. U/ 


'he brue pa-th 


■false path 


print 

("Game over!") 


You need to amend the game program to give more informative messages 
to the user. 

But what will the paths in the program look like? 
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start your engines 




Race Thck ►»»»»»»»»»>3 


Construction Kit 


The countdown's started on the Codeville Grand Prix. The 
cars have arrived, they're warming theirtires on the grid, 
and the race is aboutto start. Can you assemble the track 
so that itdisplays the rightfeedback message? Note that 
you might not need all the pieces of track. 


The vate 
stairfc line is 
•fixed hev-e- 


Number entered 

Feedback message 

3 

Too low 

5 

You win! 

7 

Too high 

8 

Too high 
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starting to code 





T levate 
VmC ' ,s 
f,*ed V»®*- 
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finish line 


«iT %+ 

'* •■*.* fc i * * * 

r* * % 


Raee Track ►»»»»»»»»»>J 

Construction KTf Solution 


The countdown's started on the Codeville Grand Prix. The 
cars have arrived, they're warming theirtires on the grid, 
and the race is aboutto start. Were you able to assemble 
the track so that it displays the right feedback message? 




guess—5? 


Number entered 

Feedback message 

3 

Too low 

5 

You win! 

7 

Too high 

8 

Too high 


print 


( "You win!") 


5? 


guess 
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connect branches 

The Python code needs 
interconnecting paths 

The solutioni mapped out, and now we know that the program code will 
need to have paths that match this: 



But isn’t there a problem here? In the design there are many interconnecting 
paths, but so far, we have only written code that contains just one branch: 


if guess == 5: 

print("You win!") 
else: 

print("You lose!") 


In the new code, we will need to connect two branches together. We need the 
second branch to appear on the false path of the first. 



I/Ve need to dormedt 
these two paths 
together 



So how do you connect branches together in Python? 
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starting to code 


Python uses indents to connect paths 

The code inside the if and e Ise statements is indented. This isn’tjust 
to make the code pretty. In Python, indents matter. Let’s consider a 
different piece of example code: something that will decide if you can 
drive downtown. Python uses indents to connect a sequence of commands 
together to form paths. 


This is *thc 

TRUE ?ath- 


This is -the 
FALSE path. 



lL i» E ytllOh ihsi 

if fuel > 3: 

print ("It's OK") 

print("You can drive downtown.") 
else: 

print("Sorry") 

print ("You don't have enough fuel") 
print("What's next?") 

This dommaud is «ot on the 
FALSE path betawse it is «ot 
i^eUed. So it W,ll ah«ays w*. 




So how do you connect branches together? You simply indent the 
second branch in by one more level. 


The 


JfVrst it bvamth 


Th,S S “°»d it bmandh 

«r f°^ied to the 
f ah ' . of the 

t^st 11 bma^eh. 


if fuel 


else 


> 3: 


print ( "It's OK") 

print ("You can drive downtown.") 
if money > 10: 

print ("You should buy some gas.") 
else: 

print ("You better stay at horne.") 
print("What's next?") 

Nohte -the ex-tra 

'»deirfca-fci 0 h. 



it! 


you indent code in 
Python; if you don’t 
indent your code correctly, your 
code might do something wildly 
different from what you expect. 


Indents matter 
in Python. 

Be careful how 


You should now have enough information to go fix the code, but 
before we do that, let’s take a look at how IDLE helps you indent 
code. 


you are here ► 


21 












idle time 



IDLE ...ataglance 


You’11 be using IDLE to enter all of the Python code in this book, so it’s 
worth taking a little time to familiarize yourself with a few of its features. 

Even though IDLE looks like a simple editor, it’s actually packed full 
of smarts that will make Python programming much easier and faster 
for you. It’s worth spending some time exploring IDLE’s menus and help 
system, but for now here’s a few handy hints to help you feel at horne. 


, . ,„ d ^ dha » 9 « the way 

Wbe, y ou ty? e 3 ... /PLE uses iolovs a,d 

bit EKTER, Pytho, i,de„ti„ 9 by elieki,* on J-L. 

au-to^atitally a,d torvettly 0 p £ iohS me ^ ( J 

i,de,t the Vme U y~ da||ed 


Eile Edit Firmat jhjun Qptions Windows 


f uel > 3: 
print("It 
print "¥o 


Ti- ! n--n 


c5.Fi dnv 


mnnf y > T 0 * 

p r i nt, | * You e houl d 

- ■— ■ 

■ * f- Bi 

7^ P ^ i r .t ( 11 You b tt ter 

| crint t Ti 1 *"h -~'z ncst?’ 1 )[ 

Be-Pore you type ‘m w else* w , make 

suve you Krt BACKSPACE to 
movc the mdcht badk o*e level. 


:y sone gi 


st iv e t hoir.e « p ) 


b, kWt m■ 

idicts usi,°j T 


«r 


/t you piress tab, /PlE 

donvev-ts i-t i,-fco SPACE 
dhavad-tev-s. 


TV»e ttely *>>«"* ""t o™y 
ciives you V,ely about 
jpLE, but it also lets you 

y-ead tbe built-m Pytbo, 

doduwC^tatioirk* 


Ln. 17 
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starting to code 


poo] pil-Z.z]6 

Your task is to take the Python code 
fragments from the pool and place 
them into the blank lines in the 
game. You may not use the same 
code fragment more than once, and 
you won't need to use all the code 
fragments. Your goal is to complete 
the guessing game program. 

Hint: Don't forget to indent. 

print("Welcome!") 
g = input("Guess the number: ") 
guess = int(g) 



Note: each code 
fragment from the 
pool can be used only 
once! 
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indent or else 



P®®1 Puzz]6 

Your task was to take the Python code 
fragments from the pool and place 
them into the blank lines in the 
game. You could not use the same 
code fragment more than once, 
and you didn't need to use all 
the code fragments. Your goal 
was to complete the guessing game 
program. 

Hint: Don't forget to indent. 


print("Welcome!") 



TV.s pie£e of toAt 
-(Vom -the -firs-fc veirsioh 
or -this p\rogva»w i s ho 
longeir meeded- 
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starting to code 



So, what happens if you run the new version of the program? 

Let’s try a few tests. Remember, you will need to switch back to the 
program window for each run and choose Run module from the menu. 



The program works! But, are the users any happier? 
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another guess 




The users stili don't like it. 

The program works, and now generates extra feedback, but 
there’s a problem. If the users want to have another guess, they 
have to run the program again. They really want the program 
to keep asking them for another guess until they finally get the 
correct answer. 

Gan you see what the problem is? 

How do we get the computer to do something repeatedly? Should 
we just make a copy of the code and paste it at the end of the file? 
That would make sure the user is asked twice. But what if they 
need to make 3 guesses? Or 4 guesses? Or 10,000 guesses? 
What about the case where the guess is correct? 

The guessing game program needs to be able to 
run some code repeatedly. 
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starting to code 



Wouldnt it be dreamy if 
there were a way to get a piece 
of code to run several times? 
But I guess it's iust a fantasy... 
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loop around 


loops let you nm the same piece 
of code over and over agam 

Programs often need to keep running the same piece of code 
many times. In addition to branches, programming languages also 
provide loops. 

Loops are a little like branches. Just like branches, loops have a 
condition (the loop condition) that is either true or false. Also, 
like the i f part of branches, if the loop condition is true, then 
a loop will run a given piece of code. For a branch, this code is 
called the body. For a loop, it’s called the loop body. 


We* the pnoyam tii«fc «aches 
T 'i «heeks th e value 

f y e loo P beW 

ded,dm 9 io do nexi 


answer="no" 


answer = 
input("Are 
we there?") 



± loop. 

£»* iht L 0 ? dli, °» « 
^ /oo P 


Atti* loo f ,^pp 

a V ba* 0* «tart of 


The big difference between a loop and a branch is how many 
times it runs the code associated with it. A branch will run its code 
only once. But a loop will run the loop body, then check the loop 
condition again and, if it’s stili true, it will run the loop body again. 
And again. And again. In fact, it will keep running the loop body 
until the loop condition becomes false. 
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starting to code 


Python'$ while loop 


Programming languages have lots of different ways of creating loops, 
but one of the simplest ways in Python is to use a while loop. Here’s 
an example: 


s»ve W "■* 
the fcrst W* 

answer = 
while 


The I 


"no" 


r 


°°P 


"no" 



U f tody i, t he 

'^ied todt tollowma 
the while" Ii 9 


HhC. 


answer == 
answer = input("Are we there? 
print ( "We 1 re there!") 

This is what the loop looks like when you write it as a Python while loop. 
The code keeps asking the question “Are we there?” until the user types 
something other than no. This is what it looks like when it runs: 


") 


The looy body is just one line «$**** 
• m -this e*am ? le, but the loo ? body ta» 

be ma*, lines of d°de- It 
mtlude branthes and othev looys. 



Did you notice that you had to set the value of the answer variable to 
something sensible before you started the loop? This is important, because 
if the answer variable doesfft already have the value no, the loop 
condition would have been false and the code in the loop body would 
never have run at ali. 

Bear that in mind. It might be useful in this next exercise... 
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change the game 



£ oh % ExenaSe 


Now, it's time to apply your programming mojo, Be warned: this exercise is kind of tricky. 
You need to rewrite your game program so it keeps running until the user guesses the 
correctanswer, You will need to use ali of the things you've learned in this chapter. You will 
need to work out the conditions for each of the branches and loops that are required. 

Remember: the program needs to keep asking the user for an answer while the current 
guess is wrong. 

Hint: If you need to testthattwo things have different values, use the != operator. 



This is -the "not 

. | / U i 


e^udl ho" operaior. 
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starting to code 




If you add these two lines of code to the top of your program: 

from random import randint 
secret = randint(1, 10) 

The secret variable will be set to a random number between 1 and 10. Modify your 
program from the facing page so thatinstead ofthe answeralways being 5, it will 
instead use a random number from 1 to 10 as the answer, 


. TW»S vevsio* ok y ouyr 

W 3 " value ^ tKe "semt 
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new game 



£oh£ ExeRdSe 
Solutio M 


You needed to rewrite your game program so it keeps running until the user guesses the 
correctanswer. You needed to use all of the things you've learned in this chapter. You 
needed to work out the conditions for each of the branches and loops that are required. 


Hint: If you need to testthattwo things have different values, use the != operator. 
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starting to code 




If you add these two lines of code to the top of your program: 

from random import randint 
secret = randint(1, 10) 

The secret variable will be set to a random number between 1 and 10. You were to 
modify your program from the facing page so that instead of the answer always being 
5, it will instead use a random number from 1 to 10 as the answer. 


tteve ave the t*» 'fvonn yandom i^povt vandmt 

| mes that tveate the ^ , 0) 

y-a Y\dor* 

p\rir\*tOWcldomc| W ) 


3UCSS =1 O 



clsC; 

prirrtCToo Iov/0 
p\r’m*tr^amC ovc\r| W ) 


you are here ► 


33 
































test drive 



So, what happens when you run the new version of your program? 




Python Shell 


£ilp Friit FihpJI jj+hug npfhnn“i Winrinwi 

Tython 3,0.1. (r3Dl:£9556 r Fcb 17 2009 , 15:15:57) 

[QCC 4.3.1] tm lirujji2 

Type "Copyright" , "credita" or n liccnoc()" for mrc Information 
v» =============================== RESTANT 


J >> 

V4olco^c ; 

Gutf^s 
TOQ iOVT 

I hf. 

TOQ hl qft 
G i; mich I.Sie-; 
Too lov 
G111 hf. 
Too low 
ftup;;tn ! Iir-: 
You wa.nl 

Grllllh! * JV h! C ! 

»> I 




fou 


The fvo^v-am keeps askm^ (or 
a^o-tkcv $uess (or as lon$ as y<. 
keep *lhe answev v/v-or^ 

The lorrtli Znswtr is now a ranAor* 
nuwkev and it should loe ditferent 
eath -time you play the gan>e- 

The pv-ogra** stops when 
you get -the answetr V"ight 



JjFip 


In laCnl d 



Your users love the program. 

And you created it all yourself. By carefully analyzing the problem, 
deciding what the feedback needed to be, and working out the intricate 
looping and branching logic, you Ve created something that really rocks. 

Well done. You're on your way to becoming a real code 
jockey. 


o 


o 




. « 
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starting to code 



Your Prograwwiwg Toolbox 

You've got Chapter 1 under your 
belt. Let's look back at what 
you've learned so far. 


# pvoydws ave 

to ^a»ds do 

fcy-arvtV^es detide 

\oo ? s tWmy. 

M » T~ - W- 

4- se-ts a *a*»>e -to a ^a wc 
* %ar . aWe ». 
* A ^ed ^ 


Py^u 7 Oo|s 

* '-f/else bva h £hes 
^ whilc loops 

* ~~ ass, 3 h ^Ch-t op traioY 
c^ual i-fcy operaW 

* /= ope^u 

* > S^caiev iU opc raW 

* ^ disp,a y s a "*«* o, *** 

* stt j - d ^ ««• 

..to £o „ verts £hawitfs fo 

J-W»tO 4 „„ d0B , BU 
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2 textual data 



E very string - 


# has its place 


I keep shix - hic! - honest 
working men. They taught me all I 
knew - hic! Their names are What.. 
and Why and... Gus... and - hic! - 
Jim, and Bob, and Lou. ^ 


Imagine trying to communicate without words. 

AII programs process data, and one of the most important types of data is text. In this 
chapter, you’ll work through the basies of textual data. You’11 automatically search 
text and get back exactly what you’re looking for. Along the way, you’ll pick up key 
programming concepts such as methods and how you can use them to bend your data 
to your will. And finally, you’ll instantly power up your programs with the help of library 
code. 


this is a new chapter 
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beari counter 


Your wew gig at Starbuzz Coffee 

Starbuzz Coffee has made a name for itself as the fastest growing 
coffee shop around. If youve seen one on your local corner, look 
across the Street; you’11 see another one. 

The Starbuzz CEO is always on the lookout for ways to boost profits, 
and he’s come up with a great idea. He wants a program that will 
show him the current price of coffee beans so that his buyers can 
make informed decisions about when to buy. 



The Siav-W» 



I had a programmer do some 
work for me, but theyre not 
answering their phone. TheyVe 
disappeared! Think you can take 
over? III let you have the code 
theyve already come up with. 
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textual data 


Here'$ the current Starbuzz code 

The previous programmer has already made a head start on 
the code, and we can use this as a basis. Here’s the existing 
Python code, but what does it do? 




WAkN 


Take a good look at the existing Starbuzz code. What do you think it 
actually does? 
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test drive 



Type the code into IDLE, save the program, and run it. 


flere* 

toAt as e^teved 
\yAp 


^7 


cj-etc off&Gf>rk*. py - yh ome/b a rry p/He a d Fir&iPr&g x h a pte r 2/c od + - 


FiIp Frtit Fnrmhf Run Ophion 1 ! Win rl nw^, 


r,[ o l* r. ur i 1 ib r r c que □ t 

page - uri 1 iis * requea t * ur lopcn i| " ht tp i / / bcoiia r ub* biE/prioca .html ) 
Lex! = M Lj^ra" ) 


f 


■l _mL ( LtfxL J 



Python shfill 


£jIf £rht F.hpji Rehug nphnn^ Winrlnwi 


\A I\\cy\ c^cdu*ted, 
-bV^c pvo^vam 
^vodutes bWis. 


s*? 


Python J.Q.I (riUlsfemqfe, le& lf iaslbs&V} 

[fter cm limia? 

Type "conyrLqht" r M ar®dita" or ”lieensetJ“ tor more informat ion 
>»-HnSTART 


<,ht3fll><hcod><titloHcI cdtec to the Beans ! R'Os Pricing Fage</title> 
^■linK ni-"etylealieet* type-"text/csB" brer-"Oeaner ! Je . cse " 

< / head><£sody> 

«■H2 ^Sfeleooe to the 3e ans ’ P." Us Pricinq Paqe't/h2> 

<p>Current priec of coffco benno — <atrong^E5 i 19</otrong><^p> 
cp^Priee valid for 13 mlnntee from 1S:*2 on treOneadlay 27/03/2O09^/p> 
</body></ht ml > 


>» 


The code youVe been left goes to the prices page on the 
Beans^Us website to get the current price of coffee 
beans. But instead of giving just the cost, it gives you all 
of the HTML text used to create the web page itself. 



UTML te«te '*'* 

La t» «* w 
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Hey, thafs not right! I only 
need to see the current 
price of coffee beans, not all 
that other stuff. Think you 
can give me just the cost? 





















textual data 


The cost is ewbedded in the HTML 

Take a closer look at the results of the program. The current price 
of beans is right in the middle of the output: 




Python Sh«LI 


£jIp rrlfct P.KifJI n-phug Win.rinw'; 

Python J. Q.l CriUl:&t03& r i’e& 17 
[ryf!r e mi 1 t rui a.? 

Type '"copy right", "credita" or " Iiceneet ) m tot more Information, 

>» —-------— bfistmt------ 

<htinl><hco.d><titlc>HcI cdilc to the Beana'R'U3 Pricing Pagc</title> 

*■- I inK te I -■" sty lesneet" type-'t ex t / cs b m hr e f - " tean e rus. cs s " /> 

< / t;cad><hQdy> 

*H2>ife Icone to the Beans r BL'D3 Pricinq Paqet^s 
<p>Currcat price of coffcc bcnnc - <at rongeE-5 * 10\/otrongx/p> 

*p>Price valid far 15 uilnutes from 19:^2 9day 27/03/2009 . t/p* 

</body></htmL> ^ \ yxCtd 

I his is ( ^ f+T/WL tode TW,S * ?ay• 

ihe pritt web P a 9e . ^ ***** 


»> 


JjFlp 


I n: 14 Coi J 


The Starbuzz GEO would find it a lot easier if you could extract 
the price of beans and just display that, rather than have to look 
for it in the HTML. But how do you do that? 

A string is a series of characters 

The output of the Starbuzz program is an example of a string. 
In other words, it’s a series of characters like this: 




Somewhere within the string is the price of coffee beans. To 
retrieve just the price, all you need to do is go to the right bit 
of the string, retrieve the characters that give the price, and 
display just those characters. But how? 


/ou only need these tew ehav-attevs 
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offset values 


Fmd characters inside the text 

The computer keeps track of individual characters by using two pieces 
of information: the start of the string and the offset of an individual 
character. The offset is how far the individual character is from the start of 
the string. 



^ aire ^ skv-i ot the 
stlrm 9 as we have moved 
the ottset is O. 











The first character in a string has an offset of 0, because it is zero 
characters from the start. The second character has an offset of 1, and 
so on: 



Ottsei 
v dlucs 



f\i start tountin$ tvorn 0, the 
ottset values are aWays o«e less 
4 -Vo,> their atW Positio»- 




The offset value is always 1 less than the position. Python lets you read a single 
character from a string by providing the offset value in square brackets 
after the variable name. Because the offset value is used to find a character, 
it is called the index of the character: 
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textual data 


Put how do you get at more thaw 
owe character? 

For Starbuzz, you don’t just need a single character. You need to extract 
the price from the string of HTML, and the price is made up of several 
characters. 

You need to extract a smaller substring from a bigger string. A substring 
is a sequence of characters contained within another string. Specifying 
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here is waldo 


_ feiharpen 






Imagine the variable s is set to the string below. Your job was to 
determine what each of the substrings provide. 



U 



w 


s[5:9] 


s [10 :12] 




s [13:18] 



^ "-mus 


I z minus IO — Z dhavadtevs 


'Waldo" 


|« minus 13- - 5 dV-avadte-rs 


In general, if you specify a substring using s [a :b] , then: 


C 


Kp h>, bu-t not indludi 
J 


ng. 


is .Ibs.mde*. ..oT.tbe.+iv-st dbayafrtex'. b is 'tbe mde* a-rtertbe lastdbavadtev 


_ j " “ b 



V 


V 




i 


tO II 


tl 









7 


13 


sf/3:/0J 



tfcven tbougb inde* I® 
is mentiondd in "tbe 
substving spedlidation, 
i-t’s not indluded in ibe 
e*tv-adted substring. 


The second 
index value is 
after the last 
character in 
the substring 

This is even though the 
first index value is the start 
character of the substring. 
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textual data 



... -^7 

i IV* 

V»as 

tV^atV ? 


You need to update the program to extract the price starting at 
the 235th character of the string.The price is four characters long. 
Store the price substring in a variable called price. Write the 
new version of the program here: 



WvvU to* **" 
t ode V>eve- 
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text[225] 


extract the price 



You needed to update the program to extract the price starting at 
the 235th character of the string.The price is four characters long 
and stored in a variable called price. 


imporfc urllibre^uest 

pajje — u\rHib.\rc^ucs*t.u\rlopcr\( u b*t'tp : //y/y/y/bcar\s—\r—us.biz/pvidcs.b*ti^rO 
*te%*t =• pa5eread0.dedode0VbP(J w ) 

\/ou sW subsferwft 
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"te*t" (the entire 2 _ u A £*'?»**** 3i j^exes 2.3+, 235, 

03 «), vou are Vu»t V , d 2 i 7 ' N °. te ho,w y«* v « spectfied the substrin» 

pwtmQ V ,te ( ^ e ' separated by the •• character. 

extracted substrin^). 
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TWis is the first tharaeter 
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textual data 



Type the code into IDLE, save the program (choose a name for 
the program that is meaningful to you), and run it. 


getcQffeRpri^S.py ■ yhom&yb a rryp/HeadFir&tProgaliiipter+ 


Ole Lciit Fflfftiat Buo Qptions Windows 
_rport urllib,rcqucat 

page - urllib*rc^uc3t i,urlopen^ "http;//'rfTfw.bcans^r-tta . biz/pricea * btml ‘ 1 
t-eict “ p age«read (). de code ( ' ut £ G ) 

prict - text [ 23^3 s 2 30 ] 
print (prict) 


python Shell 




That looks a lot cleaner. Now, instead of displaying the entire 
HTML text of the web page, you Ve cut it down to just the 
piece of the string (the substring) that you need. 




47 



















string theory 



The Stotng 'Cxposcd 

This week’s interview: 

We ask the String what it’s like 
being the worlcTs most eligible 
datatype. 


Head First: String, it’s so good of you to find the 
time to speak to us. 

String: Please, the honor is mine. Sit. Sit. Make 
yourself at horne. Did you eat yet? 

Head First: Em fine, thank you. String, where 
should I begin? You are known the world over for 
your work. In your time you Ve carried the works of 
Shakespeare, Geothe... 

String: Dan Brown. 

Head First: ...all the great works of literature. And 
even mundane things like names and addresses. Teli 
me, how did you become so popular? 

String: It’s a question of character. Well, characters. 
See, before I existed, computer Systems used to 
record text one character at a time. 

Head First: That must have been rather 
inconvenient. 

String: Inconvenient? It was a royal pain in the 
tuchis. 

Head First: Quite. 

String: Without me, handling text was like riding a 
pedal cycle without a saddle. 

Head First: In what way? 

String: It was possible to get somewhere, but the 
journey was kind of stressful. 

Head First: You simplify things. 

String: Certainly. I simplify. Instead of keeping 
track of a hundred, or a thousand, or a million 
letters, you just need keep an eye on one thing. Me! 


Head First: That’s a good point. 

String: I like to think of myself as a front. An agent, 
you might say, for all the characters I work with. 

Head First: People deal with you, so they don’t 
have to deal with individual characters in memory. 

String: Exactly. Pm an organizer. I keep an eye on 
the day to day business of the letters. If I need to be 
shorter or longer, I arrange for the characters to be 
made available. 

Head First: Teli me about your substrings. 

String: Ah, my substrings. Like chips off the old 
block. That a humble datatype should be so blessed! 

Head First: A tissue? 

String: Bless you. <blows nose>. Those boys are 
so close to me. Here’s a photo. Gan you see the 
resemblance? 

Head First: Why he looks just like... 

String: Ah, you guessed! Yes, my character 
sequence from 137 to 149. Exactly. Just like his old 
man. But shorter. Little more hair. 

Head First: Your substrings are strings as well. 

String: Certainly. Strings just like me. And they, I 
hope, should one day be able to produce their own 
substrings as well. 

Head First: Yet some people are confused by your 
indexing. 

String: What can I say? I started with nothing! 
Head First: String, thank you. 

String: A pleasure. Are you sure you ate? 
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textual data 


tfiereiare no 

Diimb Questfens 


q: So, I can put any web address into 
this code and grab the associated web 
page from the Internet? 


Yes, feel free to try it out for yourself. 


Q: Don't I need a web browser to 
view web pages? 


Yes, to view a web page in all its 
formatted glory-with embedded pictures, 
music, videos and the like-a web browser 
is a must-have. However, if all you wantto 
see is the "raw" HTM L, a browser is overkill. 



What does the import line of code 


It gives the program the ability to talk 
to the Internet. The 

urllib. request code comes as 
Standard with Python 3. 


Q: And I guess thatcall to urlopen() 
goes and gets the web page? 


That's right! The provided web 
address (or "URL"to use the properweb- 
speak) is fetched from the Internet and 
returned by the call to urlopen (). 

In this code, the fetched web page is 
assigned to the page variable. 



And the urllib.request bit? 


Thatjust telis the program to use the 
urlopen () function thatcomes as 
Standard with Python 3's Internet page— 
reading technology. Well have more to say 
about urllib. request in a little bit. 
For now, justthink how lucky we all are not 
to have to write code to fetch web pages 
from the Internet. 


I getthatthe call to read() actually 
reads the web page from the page 
variable, butwhat's thatdecode("utf8") 
thing? 

When the web page is fetched from 
the Internet, it is in a "raw" textual format. 
This format can be a little hard for humans 
to read. The call to decode () converts 
the raw web page into something that looks 
a little easier on the eye. 

To see whatwe mean, try removing the 
call to decode () from the program and 
running the code again. Looks a little weird, 
doesn'tit? (Don't forget to put the call to 
decode () back in before continuing.) 



BULLET 


POINIS 


■ You can download the HTML of a 
web page as a textual string. 

■ A string is a sequence of characters. 

■ You can access individual characters 
in a string using an offset. 

■ The offset is known as the index 
valueofthe character (orjust index 
forshort). 

■ Strings within strings are called 

substrings. 


Substrings are specified using 
two index values-for example: 

text [10:20]. 

The first index value is the location of 
the first character of the substring. 

The second index value is the 
location afterthe last character of the 
substring (up to, but not including). 

Subtractthe second index from 
the first to work out how long the 
substring should be. 
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change of address 


PeansTUs is rewarding loyal customers 

The GEO just got great news from the beans supplier. 


The supplier is so happy 
about all the business were giving 
them that they are going to make 
us members of their loyalty discount 
program. They say it should be a 
simple f ix. Can you look into it? 


The supplier actually maintains two prices: one for regular customers 
and one for loyalty program customers. The different prices are published on 
different web pages: 

Re$ulav dus-tomevs yt 

http://www.beans-r-us.biz/prices.html 


^°X)wcv-s http : / / www. beans-r-us . biz/prices-loyalty . html 

■tV\civ ^r\tts hcvc ^ 


That means you need to change the web page address in the code: 



import urllib.request 


page = urllib.request.urlopen("http://www.beans-r-us.biz/prices-loyalty.html") 

text = page.read().decode("utf8") 

b is 


price = text[234:238] 
print(price) 


<3ddm 




css. 


Let's run it to make sure everything works OK. 
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textual data 



This time when you run it, this happens... 



The program is no longer displaying a price. So what happened? 


The price woved 


The web page for loyalty customers is much more dynamic that the old 
web page. The page for regular customers always displays the price in a 
substring beginning at index 234. That’s not true for the loyalty program 
web page. The price on that page can be almost anywhere. All you know 
for sure is that the price follows the substring >$: 






the sbrwty 









A» you Iw is that the pw de 
• ollov/s these two dhavaete«. 







You need to search for the price string. 
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searching for substrings 


Searching is complex 

You already know how to find a substring, so you could run through the 
entire web page and check each two characters to see if they match >$, 
like this: 






lAfe dould seav-th “the 

yjViole stvi»>5 -fov lookmj 
at 2- dhavafctev-s at a W- 











WtVt toUKd 


So tViese ne*t ^T 
tViavattevs miAst ce 

the ?vite, vi^t? 



1 

4.1 

R 








You could do it this way... but should you? 


There’s a lot to worry about. Which two characters are you currently 
comparing? Where in the string are you right now? What if "> $ ” isn’t 
found? Searching for substrings in strings is a little more complex than it 
first appears... 


But if you don't want to write code to search the 
string, what else could you do? 
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textual data 



Wouldnt it be dreamy if there were 
a simple way to search a string for a 
substring? But I suppose +ha+'s just a 
fan+asy... 
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smart data 


Python data is smart 

The more code you write, the more you will find that you need to do the 
same kind of things to the data in your variables all the time. To prevent 
you from having to create the same code over and over, programming 
languages provide built-in functionality to help you avoid writing 
unnecessary code. Python data is smart it can do things. 

Let’s look at an example. 

Imagine you have a piece of text in a variable that you want to display in 
uppercase (all CAPITAL letters): 


msg = "Monster truck rally. 4pm. Monday." 


You could write code that read through each character in the string and 
printed out the matching uppercase letter. But if you’re programming in a 
language like Python, you can do this: 


The 

"tali 

-the 


dot ntdrt „ 

'^J r ° is a ^ ih 9 ^°d. 

print(msg.upper()) 


MONSTER TRUCK RALLY. 4PM. MONDAY. 


Wcrc s wha^t <^ets 
displayed, -the value of 
ihe "n*sg" vairiable ih 

UPPBRCASS. 


But what does msg. upper () mean? 

Well, msg is the string containing our piece of text. The . upper () that 
follows it is called a string method. A method is just an instruction for the 
string. When you call msg . upper (), you are telling the string to give 
you an UPPERCASE version of its data. 

But is there a string method that can help you search 
for a substring within a string object? 
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textual data 


IV 


These are some of the many built-in string methods that come with 
Python. Match each method to what it does. WeVe done one for you 
already. 


MefW 


text.endswithC.jpg") 



Whht the mefjiod does 


Return a copy of the string with all occurrences of one 
substring replaced by another. 


Return a copy of the string converted to lowercase. 


Return the value True if the string has the given 
substring at the beginning. 

Return the value True if the string has the given 
substring at the end. 

Return the first index value when the given substring is 
found. 


Return a copy of the string with the leading and 
trailing whitespace removed. 


Return a copy of the string converted to uppercase. 



Which of the above methods do you need to use to locate the 
price substring within the Beans'R'Us web page? 
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find, the right method 




These are some of the many built-in string methods that come with 
Python. You were to match each method to what it does. 


M eth°d 


What the method does 



Return a copy of the string with ali occurrences of one 
substring replaced by another. 


Return a copy of the string converted to lowercase. 


Return the value True if the string has the given 
substring at the beginning. 

Return the value True if the string has the given 
substring at the end. 

Return the first index value when the given substring is 
found. 


Return a copy of the string with the leading and 
trailing whitespace removed. 


Return a copy of the string converted to uppercase. 



Which of the above methods do you need to use to locate the 
price substring within the Beans'R'Us web page? 


The w -PmdO w method 
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textual data 



You need to update your price-grabbing program so that it extracts the four-character substring 
thatfollows the occurence ofthe ">$" characters. Write the new version ofyourcode in the 
space provided. 

Hints: Don't forget that the findo method finds the starting position of a substring. Once 
you've found use Python's addition operator to calculate where in the string you wantto 
extract the substring. The addition operator is the "+" Symbol. 


Seavth U -tWs l-tbavatW 

towibmatio»'- \ I look ing _P ol _ 

r ^ 

coffee beans = <strong>$5.49</ 
strong></p><p>Price valid for 
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finding the dea! 



ExemSe 

§OLut\OH 


You needed to update your price-grabbing program so that it extracts the four-character 
substring thatfollows the occurence of the ">$”characters. 

Hints: Don't forget that the find () method finds the starting position of a substring. Once 
you've found use Python's addition operator to calculate where in the string you wantto 
extract the substring. The addition operator is the "+" Symbol. 


/^impo\rt uvllibv-e^uest 


This dode 
hasjr/t . 
dhanged. * 


pa<je — uy||ib.ye^uestuV"lopenO*http : / / v/v/v/beans--\r--us.biz/ pvides.html”) 
te*t — pa^e.yeadO.dedodeOVtfS”) 


S r 3 ±f h imJe * .. 

e >, iombiha-tion. - -tex-t-PW^W ) 


TViis is the addition opevaW- 

The stavt o( the adtual pvide 
is anothev Z inde* positions 
aUg the string, while the end 
o\ the pyide is another 



star t^rfjpride =■ y/hev-e + Z ^ 
end^o^jpride — stav-tj^f^pv-ide + 



pvide — te^tCstav-t^o-f^pv-ide^ehd^o^pyideJ 


pvint/pvidc) 

Did you vemer»bev to 
pv-iht out the pvide 
ohde you ; d -Pound it? 



1/Vith the stavt and end index, 
lodations knovm, it*s easy to 
spedi-fy the substvin^ ve<\uived- 
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textual data 



OK, so your program should now be able to find the price, no matter 
where it appears in the page. 



It works! By adding very little extra code, you have made the program 
much smarter and more useful. 
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frugality feature 




- ' 1 4 1 ’ ’ r - u ■ - > ‘ "//Sr 

. i .1 J , * . J r . 



The new version of the program works, but 
now there s a design issue. 

The Starbuzz GEO wants to know when the price of 
the beans falis below $4.74. The program needs to keep 
checking the Beans’R’Us website until that happens. It’s 
time to restructure the program to add in this new feature. 

Let's add a loop to the program that stops 
when the price of coffee is right. 


60 Chapter 2 













textual data 



Code Magnets 


The program code to add the feature is sitting on the fridge door. 
Your job is to arrange the magnets so that the program loops until 
the price falis to $4.74 or lower. 
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Code Magnets Solution 

The program code to add the feature was sitting on the fridge door. 
You were asked to arrange the magnets so that the program loops 
until the price falis to $4.74 or lower. 



D'»d 70U . 

v-cwcwbcv" 

tV\Csc Imcs? \ 
T \\ty av-c 
*msidc “the 
loof. 


end_o f_price = start_of_price + 4 



print ("Buy!") 


] 


fWis W sVwwWr» t 
te mde^ted. as «t s 
owtside '°°?' 
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textual data 



Enter the new ver sion of the program code into an IDLE edit window and 
run it. 


g etcoffeeprite4, p y - /h rry p HeadF ir^t P rog /cli ap tc r^c&d«/g«teoffeepri ce4. p) + - a x 


Lite ictit f armat liun aptioris Windows 


Help 


m 11 Ib * x s L 

pricc - 59.9S 
wiii . -■ prlce 4.74: 

paqe « urllib * reque a t „ urlopen {" Jit t p: / / ww„ be a n a » r-ua. b±r/pr icea ^loyalty. htnl" J 
tej(t ■ pa-cjer * l er ad £ ) . 4in_~4JiJe f " u LIE ^ ] 

h* tftxt.lf tnd ^ F >E " y 



et4rC_Eit_price - wn-a 
end_of_pr±ce - etart 

■ji in 1 ■ LritLpLaiL u 

print £ "DuyJ p } 




4 - 'J 


nere s youv 

pv-ogiram ude 
typed m-fco 
IDLB. 


Python Sha 


fil^ j£rirt fihpjl Hpbiicy Qptmns Winrinws 

Python 3.0,1 <riei:*933& r Fe& 17 2009 r 15:13:373 
[ HC -3,3,2; on littis? 

Type "Copyright" # "credite" or 'Iicenae(3" Eor nnore Information, 

»> mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm JLE STAHT 

JP>> 


M What’»^ 




Tx.flL'ebdLi pjrrua L s, er.-t-ii L, ea 11 1 a a t ) : 

Filer "/Due , i iiner:3La/'cgerLeuf feeyi iee-i . py “ r lirus; 3 r in ^modiu. 1 er> 
wh i 1 a prt clr: > 4 .74: 

Typ^Ei"rnr = unrirdr-rnhlr tyTxrni -nfctrj) 5- 

»> | 


It looks like something’s gone wrong with the program. What does 
TypeError mean? What’s happened? 



«AkN 




Look at the error message in detail. Try to identify which line in the code 
caused the crash and guess what a TypeError might be. Why do you 
think the code crashed? 
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type differences 


Strings and numbers are different 

The program crashed because it tried to compare a string with 
a number, which is something that doesn’t make a lot of sense 
to a computer program. When a piece of data is classified as a 
string or a number, this refers to more than just the contents of the 
variable. We are also referring to its datatype. If two pieces of 
data are different types , we can’t compare them to each other. 



Think back to the previous chapter. YouVe seen this problem before, 
back when you were working on the guessing game program: 


TWis vaviable Will V»c 
set b> a wmbev. 


« » . 

9 ' s a siir 



X 


guess = int(g) 




J a Alir • 


In the guessing-game program, you needed to convert the user’s guess 
into an integer (a whole number) by using the int () function. 

But coffee bean prices arerft whole numbers, because they contain 
numbers after a decimal point. They are floating point numbers 
or floats, and to convert a string to a float, you need to use a 
function other than int () . You need to use float () : 


float ("4.99”) 



Uke mtO, Wt *orks W.tk 

■tkat tontai» a detwal 
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textual data 



Tqst Drwq 


This should be a pretty quick fix. If you use the f loat () function to 
convert the price substring, you should then be able to compare the 
price to 4.74: 



g etco^fcc p rk 1 4. p y - ih emc/lia rryp/H tad Fif stProg.ichapter^code.ig^coffecprl cc4, + - n x 


Efclhf Edit Fyiirdt Rem Optimii Wiialow^ 


Help 


ut 11 ib. i tLT-f a L 


price - 99,99 
'.-t,: _c price > 4.74 : 

paqe - ur11iP. request. urlope n { " fit z p i //wv. beans-r-u e.Pia/price s-loyal ty. fi tml n | 
t.ftx t — pjiqir-. rrnrl ( '| _ [ ' n f f f‘ H ) 

wlett = Ltixlj f 1 > ? ) 

atart_oi_price — ufiere + 'J. 

sf 2 :d ol pji. it: tr — aLtirL cjI pr tue + 4 

price ~ f Icat \ teKii starr of price : er,(3 of pric e j ) 


' 


pr i nt {"Uuy!" J 


The ufdated tode 


That’s much better. Your program now waits patiently until the 
price falis to the right level and only then does it teli the GEO that 
the time is right to buy a fresh bateh of coffee beans. 


The prograr» ruhs 
with ko plroblems 
“this -time- 


J 
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TH E DE PARTMENT OE WEBLAND SECURET 
ua&*afi WHERE YOU LIVE) 

WASHINGTON, D.G. 


From; Th e ^ 

Secret Service 


To Whom Xt May Con nistributed Denial 

• fion into an apparent biz doma in 

A recent investiga ^ on the «ww. beans ^ machin es 

of Service ( DDo the traffic origma d the worid. 

showed that l starbu zz lW a pea* of 

l0 ° at Tt of «.» d*®' reS “ 1Md “ 

The numbe t nd re quest lting in a 

several hundred servers, resui 

w nf the Beanb 

3 013 It loss of business. 

significant thls office 

■en the powers invested i a i e rting the 

in accordance wit rne y General, we klnd of 

bY the United States ^ ^ we take of 

de veioper of the 

thing. m short. ourse lf ° n notice. 

, Bud Consider yourseJ- 

we , re watching you. Bu • 


Yours 


faithfullY, 


Head of internet 


Affai rs 


That sounds weird. What happened? 


Chapter 2 


textual data 


The program has overloaded 
the PeawsTUs Server 


It looks like there’s a problem with the program. It’s sending so many 
requests that it overwhelmed the Beans^Us website. So why did that 
happen? Let’s look at the code and see: 

import urllib.request 
price = 99.99 
while price > 4.74: 

page = urllib.request.urlopen("http://www.beans-r-us.biz/prices.html") 
text = page.read().decode("utf8") 
where = text.find('>$') 
start_of_price = where + 2 
end_of_price = start_of_price + 4 
price = float(text[start_of_price:end_of_price]) 
print ("Buy!") 


WeirVs -the Coit 
as i-fc £u\rren-fc|y 
s-tahds. 



If the value of price isn’t low enough (if 
it’s more than 4.74), the program goes back 
to the top of the loop immediately and sends 
another request. 

With the code written this way, the program 
will generate thousands of requests per 
hour. Multiply that by all the Starbuzz 
outlets around the world, and you can start 
to see the scale of the problem: 


You need to delay the pricing 
requests. But how? 
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Time... if only you bad more of it 

Just when you’re feeling completely lost, you get a phone call 
from the Starbuzz coder who wrote the original version of 
the program: 


\ 



It seems that she can’t get back because of a storm in the 
mountains. But she does make a suggestion. You need to regulate 
how often you make a request of the Beans’R’Us web server. One 
way to do this is to use the time library. This will apparently 
make it possible to send requests every 15 minutes or so, which 
should help to lighten the load. 

There 5 s just one thing: what 5 s a library? 
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textual data 


YouYe already using library code 

Look at the first line of the original code: 



FI r* ** -fctrf i, 

the libvavy.' 


The import line telis Python that you intend to use some library code 
called urllib.request.A library is a bunch of prewritten code that 
you can use in your own programs. In this case, the urllib.request 
code accesses data on the Web. This is a library that comes as Standard with 
Python. 

To see how the code is used, look at this line: 



Libvav-y 


fcverv V.Wav'/ fcowtam* 
UW ^at 70« tav> _ 
wse m yo*r <w ?^ a " 


The code that follows the = sign is calling a function in urllib . 
re que st called urlopen () . Notice how we say we want the code: 
urllib . request, followed by a then the name of the function. 




But how will the time library help us? Let's see... 
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find the time 



£orfg EmciSe 


These are some of the functions provided by Python's built-in time library: 


Python Libraiy Documentation: time 


““'^current time in aeconds, gi«n ,s a Latine, 
point number. 

time.daylightO e not currently in 

This returns 0 ir Y ou 

Daylight Savings Time. 

time.gmtime() time (not affected 

Telis you current UTC aate 

by the timezone). 

time, localtime () . time (is affected by 

Telis you the current locai time 

your timezone). 

time.sleep(secs) specified number of 

Don't do anything for the spec 

seconds. 

time.time() . prnnds since January lst, 

Telis you the number of seconas 

1970. 

time.timezoneO f h nrs difference between 

Telia vou the number of hours un 

and the UTC timezone (London). 
your timezone and tne 


You need to use one of these functions to help you fix your code. 

But which one? Draw a circle around the function you think you might need. 
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textual data 


With the appropriate function identified, amend the code to control how often the request for 
the web page is sentto the server. The Beans'R'Us webmaster has been in touch to say that 
their web-based pricing information is updated every 15 minutes. Fili in the blanks in the code 
as indicated by the dashed lines. 

Hints: 15 minutes equates to 15 multiplied by 60 seconds, which is 900 seconds. Also: to use 
the functionality provided by a library, remember to import it first. 


import urllib.request 


price = 99.99 
while price > 4.74: 


page = urllib.request.urlopen("http://www.beans-r-us.biz/prices.html") 
text = page.read().decode("utf8") 
where = text.find( f >$ f ) 
start_of_price = where + 2 
end_of_price = start_of_price + 4 
price = float(text[start_of_price:end_of_price]) 
print ( "Buy!") 
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time is on our side 



fjo h£ E xe aci Se 
Solutio M 


These are some of the functions provided by PythorVs built-in time library: 


Python library Documentation: time 


time.clock() 


The 


current time in seconds, given 


as a 


floating 


point numbe 

time.daylight() 


This 


n -i f 7 \/nn are not currently 
returns 0 ir you aic 


in 


Daylight Savings Time 


time .gmtime () 


Telis you current UTC dat< 
by the timezone). 


and time (not affected 


time.localtime() 

Telis you 


the current local time (rs affected by 


^our^^si^tezone) 


"time.sleep(secs) 

Don't do a 


nyth\ng for the specified number of 


7 1 

TWis looks 
Vike V>est 
Wfcio* io «se. 


time.time() =oconds since January lst, 

Telis you the number of seconas 

1970. 

time. timezone () „ difference between 

Tpiis you the number of hours aure 

o and the UTC timezone (London). 
your timezone and tne u 


You need to use one of these functions to help you fix your code. 

But which one? You were to draw a circle around the function you thoughtyou 
might need. 
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textual data 


With the appropriate function identified, you were to amend the code to control how often the 
requestforthe web page is sentto the server. The Beans'R'Us webmasterhas been in touch 
to say thattheir web-based pricing information is updated every 15 minutes.You were to fili in 
the blanks in the code as indicated by the dashed lines. 

Hints: 15 minutes equates to 15 multiplied by 60 seconds, which is 900 seconds. Also: to use 
the functionality provided by a library, rememberto importitfirst. 


ImPort the liWavY at the t°j> 
Uw.tv that the hWavy 


m 


f Ycov\At&' 

import urllib.request 

inr\po\r*t 


price = 99.99 
while price > 4.74: 


M Se ^‘ilities of the ti*e 

K*Vj» ^ P^a* £ 

1 between ttyesU 


page = urllib.request.urlopen("http://www.beans-r-us.biz/prices.html") 
text = page.read().decode("utf8") 
where = text.find( f >$ f ) 
start_of_price = where + 2 
end_of_price = start_of_price + 4 
price = float(text[start_of_price:end_of_price]) 
print ( "Buy!") 
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coffee ali around 


Order is rcstored 

Starbuzz Coffee is off the blacklist, because their price-checking 
programs no longer kill the Beans’R’Us web server. The nice 
people at Webland Security have, rather quietly, gone away. 

Coffee beans get ordered when the price is right! 
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textual data 



Your Prograwwiwg Toolbox 

YoiTve got Chapter 2 under your 
belt. Let's look back at what you've 
learned in this chapter: 




... J 

* St** « “T»" ^ ,^ e< . 

* |ndivid»al thavafrt 

. _ .Cfsets ttat start z£ ' ro ' 

* Indici'- valwes ave ok\^ 

,. LV -UnCtionauty 

* M** ” a MfetW J „^d 

* pvo^vam^ liWavies JVO 
wt-tofc tode and WW' 

? I - aata -»n vaviaWes also fcave a 

* As «dl as Viav-5 a <aU, data 
"data ty>e ” 


* hlwmlocv is a data type- 

* Stvinpy is a data type- 


^ _ ac ^ess thc 5-fU /L, / /, 

whi ^ is a stning ^^dtev ot £hc vav-iable V, 

^ ZJ __ a//.. i . 

bu t not indluding) " * W '^' h ^'»9 V ( u p 

*f" d0 *' eihod 4<r SC ^U 9 stvihjs 
^PBRCAsB^ ** <; ° hVc ^ ih 9 s ^ ri **9 s to 

^ ^od"LO Corw/erl-' i 

known as "-floais" ^ e£ " 1,a l poih-t numbevs 

* ^ Oh opcir^-tov- 

9^-tcir -th<3h opc^aW 
t ,r »C liblrdlry -f 0 ^. __ l- 


Wo " km 9 daies/litog 


Web 
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3 ¥imctfons 




Let's get organized 




As programs grow, the code often becomes more complex. 

And complex code can be hard to read, and even harder to maintain. One way of 
managing this complexity is to create functions. Functions are snippets of code that 
you use as needed from within your program. They allow you to separate out common 
actions, and this means that they make your code easier to read and easier to maintain. 
In this chapter, you’ll discover how a little function knowledge can make your coding life 
a whole lot easier. 
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emergency option 


Starbuzz is out of beans! 


The Starbuzz buyers love the program you created in the 
last chapter. Thanks to your efforts, the Starbuzz GEO 


is only buying coffee beans when the price drops below 


$4.74, and his organization is saving money as a resuit. 

But, now there’s a problem: some Starbuzz outlets have 
run out of beans. 



We have a worldwide crisis! WeVe 
run out of coffee beans in some of our 
Stores, and weve lost some customers, too 
My buyers are only buying coffee when 
the cost is low, but if we run short on 
coffee suppi ies, III pay any price. 


When the coffee beans start to run low in an outlet, 
the Starbuzz baristas need to be able to send an 
emergency order to the GEO. The outlets need 
some way of immediately requesting the purchase of 
coffee beans at the current price, regardless of what 
that price is. They also need the option of waiting for 
the best price, too, just like in the current program. 


The program needs an extra option. 
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functions 


What does the mw program need to do? 

The new program for Starbuzz needs to give the user two options. 

The first option is to watch and wait for the price of coffee beans to drop. 
If the user chooses this option, the program should run exactly as it did 
before. 

The second option is for the user to place an emergency order. If the user 
chooses this option, the program should immediately display the current 
price from the supplier’s website. 



Here's the existing code for Starbuzz. You need to modify the program 
to add an emergency report feature that will immediately report the 
current price. Which parts of the code can you reuse to generate the 
emergency report? Grab your pencil and circle the part of the code you 
think you might reuse. Why do you think you'll need to resuse this code? 


import urllib.request 
import time 

price = 99.99 
while price > 4.74: 

time.sleep(900) 

page = urllib.request.urlopen("http://www.beans-r-us.biz/prices.html") 

text = page.read().decode("utf8") 

where = text.find('>$’) 

start_of_price = where + 2 

end_of_price = start_of_price + 4 

price = float(text[start_of_price:end_of_price]) 

print ( "Buy!") 
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reuse code 



Here's the existing code for Starbuzz. You needed to modify the program 
to add an emergency report feature which will immediately report the 
current price. Which parts of the code can you reuse to generate the 
emergency report? You were to circle the part of the code you think you 
might reuse as well as state why you might need to reuse it: 


import urllib.request 
import time 

price = 99.99 
while price > 4.74: 

time.sleep(900) 


Heve's the toAt you 

tdY\ VCUSC- 



page = urllib.request.urlopen("http://www.beans-r-us.biz/prices.html") 
text = page.read().decode("utf8") 
where = text.find('>$’) 
start_of_price = where + 2 
end_of_price = start_of_price + 4 
price = float(text[start_of_price:end_of_price]) 


print ( "Buy!") 


you wai-fc &*. t he 
r'9ht price c*- vr^uest ah 
ejhevgendy ordor, you'11 , eed 
■this iode ih eadh dase- 
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If you just copy and paste the same code, 
it could make your program very long. And 
hard to maintain. That's why you don't want 
to duplicate the code. 


md<yhe i+ you 

had "to maih-taih a 

piro^vahft "tlVis leh^-th- 













functions 


Pow't duplicate your code... 


When you need to add a new feature to a program that’s similar to some 
other code in the program, you might be tempted to just copy and paste 
the code. 

In practice, that’s actually a pretty bad idea, because it can lead to code 
bloat. Code bloat means that you have more code in your program than 
you actually need. Your programs will get longer, and theydl get a lot 
harder to maintain. 


vwt faa «-t 

CMC* tode 'NTi-tte* 'i 


Heres the printout of the tic-tac-toe 
game. If you really want me to change the 
colors of the crosses, T\\ just need to replace 
the code that displays each of the 9 squares. Thafs 
the same code in 9 different places. Oh, and if you 
want me to change the Os... 


... Reuse your code instead 

Programming languages ali come with features that allow you to reuse 
code. So what’s the difference between copying and reusing code? 



If you copy code, you simply duplicate it. But when you reuse code, you 
have a single copy of the code that you can call in ali the places that 
you need it. Not only will your programs be shorter, but it also means that 
when you amend code, you will need to change it only once and in one 

place only. 


So you want a new gravity-bomb 
launcher added to each of the 
star-fighters? No problem. T\\ change 
a few lines of code and every craft in 
the f leet will be updated. 


O Q 


So code reuse is a good thing. But how do you do it? 
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define your functiori 


^ive *fche -Puhd-tioh 3 hame. 


TV>e tode 
\jo\ a sV\av*c ' s 
\hd^tcd* 


Rcusc code with functions 

Most programming languages let you create reusable, shareable code with 
functions. A function is a chunk of code that you separate out from the 
rest of your program, give a name, and then call from your code. 

Different languages have different ways of creating functions. In Python, 
use the def keyword to define a new function. Here’s some Python code 
that defines a make_smoothie ( ) function: 

TV>e vareafceses ave '.^ov-tan-t, 

S so be s»ve to \Mt 0**. 

def make_smoothie () : 

juice = input("What juice would you like? ") 
fruit = input("OK - and how about the fruit? ") 
print ( "Thanks. Let's go!") 
print("Crushing the ice...") 
print ("Blending the " + fruit) 

print("Now adding in the " + juice + " juice") 
print("Finished! There's your " + fruit + " and " 


\s a 


A c 

feo^ed-v? ?' ete * 
y-evsaWe t<xk 





In Python, it’s important that you define the function before you use it, so 
make sure the code that calls (or uses) the function comes after the definition 
of the function: 


/ 


/ 


Call the 

^Uh£fcioh. 
Noie the' 
use o( 
pa\rehs. 


1 


print("Welcome to smoothie-matic 2.0") 
another = "Y" - 

while another == "Y": ^ ^ 

make_smoothie() 

another = input("How about another(Y/N)? ") 



/ 







Every time that Python sees make_smoothie () in the code, it jumps 
to the code in the make_smoothie () function. It runs the code in the 
function until it gets to the end, and then returns to the next line in the 
code that called it. 


eyvt o*r»W of ^ 

* jrf vwrvS tod , e 

fcrfU to#*”: ' J tode- TV> e 

f 1 %*» “* b 

a 


f 


VAY\l 




t ode 


Let's use functions to share code within your program. 
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functions 



Code Magnets 


Before you amend the existing coffee bean program code, let's 
see if you can create a function to display the current bean price. 
Rearrange the magnets in the correct order to create the function: 



\A/ e ’v e aWen 70« a V ' ea<i 

addm5 0* 


page = urllib. request .urlopen ("http: //www.beans-r-us .biz/prices . html") 

text = page.read().decode("utf8") 

where = text.find(’>$') 

start_of_price = where + 2 

end_of_price = start_of_price + 4 
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order matters 



Coae Magnets Solution 

Before you amend the existing coffee bean program code, let's see 
if you can create a function to display the current bean price. You 
were to rearrange the magnets in the correct order to create the 
function: 


You stili »eed to i»?*rt UWaries 
bc-fovc them m a *uv\raon- 



Tbe -function 

de-fmitiofi 
starts bere- 


Tbe body o£ tbe -Curtio* 
needs to be mdented- 


You heed a dolor, a-Pter 

tte TUhdtior, hame- 





page = urllib.request.urlopen("http://www.beans-r-us.biz/prices.html") 

text = page.read().decode("utf8") 

where = text.find(’>$') 

start_of_price = where + 2 

end_of_price = start_of_price + 4 


The ^eeds 

*to be defclared 
be-fore its fcallcd* 




Tbc -function 
defmVbon crvds here- 




/ 

Th.s l.hc ish t ihdch-tcd, 
bccausc it is pav-t of 
tbc rudiin progra**. 


Always get things in the right order 

When it comes to functions, the order in which you do things 
really matters. The get_price () function needs to be 
defined before you call it. And because the function relies upon 
some code in the urllib . request library, you need to make 
sure that the import line appears before the function, too. 

Let's see if your new code works. 



order m whidh 
io -tbmjs is-? 
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functions 



Type the code on the opposite page into IDLE, and run it to see what 
happens: 


gutprice.py - /homeybarrypjfheadFirstFrog/ch a pter3/code/kjetprke.py 


Fik EdsL Fuinidt Rtm Oplioni Winduw;* 


i n- ; l ;; ■ u rl 1 ib. reducat 

!h- ! ijm 1 _ p r i iif ij ) i 

page = ur 11 ib.retjuea t.urlopen ( "ht tp: / /ww.beans-r-us.blz/prlces . btml" J 

text - page. re ad [ ] . decode < "ut £ a " ] 

where - text. f ind^ ">S" J 

»LnrL ciif pr iiie-; = iwli*-?rr; + 7 

end ol price = start of price + 3 

pnntij text | a tart ol_pnco: e nd ol_price | ) 

get_p-rioe () 




I^Vhch "this Codt vuhs, 
the pvide is displayed 
' r '3ht away. (Ho{.e- you 
^y see a ditfeveh-fc 
pv-i^c whch you vuh your 
£od C .) 7 


The price appears immediately. You now have a function that reads the 
contents of the page from the supplier’s website and prints out the price 
information. 

You can reuse the function in lots of places in your program simply by 
calling the get_price () function. Now all you have to do is modify 
your existing program to use the new function. 





W 

Look back at the original program at the start of the chapter. You know that you 
can use this function to produce emergency reports. But it will also need to 
replace the existing price-watch code. Is there a problem? Why? Why not? 
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limits of print 



Functions are great for reusing code, but they 
really come into their own when they perform 
an action for you, then give you back some 
data to use in whichever way you want. 


The current version of the get_price () function prints out 
the price of coffee beans every time it is used, or called. This 
is OK if that’s what you really want it to do. The trouble is, you 
need the function to give you the price so that you can then 
decide what you want to do with it. 



discount = 0.9 


print ("The discounted price is: ") 
price = get_price() 
actual_price = price * discount 
print (str (actual_price)) 



The "ge-t-pvideO" 
+uhfrfcioh. Even -the 
»ar«e -telis you a little 
abou-t wha-t i-t does. 
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functions 


Returw data with the return co wwand 

If you use the return () command within a function, you can send a 
data value back to the calling code. 


import urllib.request 


def get_price(): 

page = urllib.request.urlopen( M http://www.beans-r-us.biz/prices.html M ) 

1 / \ 1 1 / 1I i r* ■■ V 


text = page.read().decode("utf8") 
where = text.find('>$') 
start_of_price = where + 2 
end_of_price = start_of_j?rice + 4 

print (toitt fstart o f price:end cif prie e l) 


Remove “the tali to 


u 




return (text [start of_j?rice: end of_price]) <- 


- 3hd «repi ate it with a 
da, l 'Vetuv-hO" ihstead. 


Call the w 9et_pHe e 0" 

Wtio». 



happe^s atter the tode m 
the -fttnttioir» e*etutes- 
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don’t repeat yourself 


tfiereiqre no 

Dumb Questipns 


% The return() command is just like printQ, except nothing 
appears on screen, right? 


O: What happens if the function omits the return() 
command? Does each function have to have one? 


Well... sort of. The print () command is designed 
to display (or output) a message, typically on screen. The 
return ( ) command is designed to allow you to arrange for a 
function you write to provide a value to your program. Recall the 
use of randint () in Chapter 1: a random number between 
two values was returned to yourcode. So, obviously, when 
providing your code with a random number, the randint () 
function uses return ( ) and not pr int (). In fact, if 
randint ( ) used print ( ) instead of return () , it 
would be pretty useless as a reusable function. 


O: So, it's a case of return() letting a function give you 
something back? 


Yes, that's it, exactly. 


NL- l'm not sure l'm convinced aboutusing functions. Isn't 
using copy'n'paste quick and easy? 

No, using copy'n'paste is quick and dirty, with the emphasis 
on the "dirty." When you need to repeatedly use some code, it's 
always betterto create a function to contain and name thatcode. 
You then call (or invoke) the function as needed. If you later decide 
to change howthe repeated code works, it's a no-brainerto change 
the code in the function once. If, instead, you "quickly" performed 
copy'n'paste five times, that's five changes you now have to make, 
and the chance ofyou missing one change or making a mistake are 
actually pretty high. So, don'tcopy'n'paste! 


Q; So, using a function lets you share the repeated code in 
a controlled way? 


Yes, it does. There's also a guiding principle among 
prgrammers known as DRY: Don't Repeat Yourself. Using functions 
lets you keep yourcode DRY. 


No, the use of return () is not required. In fact, the 
current version of your get_pr ice () function doesn't use 
return () atall. But, your function feels like itgives you 
something because it prints the current price on screen. When the 
return () command is omitted, a function returns a special no 
value. In Python, this value is called None. 



So, justto be ciear, using return() is optional? 


A: 


Yes, it is. 



Does return() always come at the end of the function? 


Usually, but this is nota requirement, either. The 
return () can appear anywhere within a function and, when it 
is executed, control returns to the calling code from that point in the 
function. It is perfectly reasonable, for instance, to have multiple 
uses of return () within a function, perhaps embedded 
with if statements which then provide a way to control which 
return () is invoked when. 


0 : 


caller? 


Can return() send more than one resuit back to the 


Yes, it can. return () can provide a list of results to the 
calling code. But, let's notgetahead ofourselves, because lists are 
not covered until the next chapter. And there's a little bit more to 
leam about using return () first, so let's read on and get back 
to work. 
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Using the new get_price () function, write a new version of the 
price-checking program that does this: 

1. Ask the user to indicate if the price is required immediately (Y/N). 

2. If the user chooses"Y"for"yes,''find the current price and display it 
on the screen. 

3. Otherwise, check the price every 15 minutes until it falis below 
$4.74, then (and only then), display the price on screen. 


you are here ► 
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buy it now 



Using the new get_price () function, you were asked to write a 
new version of the price-checking program that does this: 

1. Ask the user to indicate if the price is required immediately (Y/N). 


Youv Lodc '°°k a f I) 
di-f-fev-ert bro** th»s, ^t s 
f \s Ias it docs tbe samc 

tWwfy youVe ^ om 5 


2. If the user chooses "Y"for "yes,"find the current price and display it 
on the screen. 

3. Otherwise, check the price every 15 minutes until it falis below 
$4.74, then (and only then), display the price on screen. 


imporfc u\rllib\re<\uest 


import time 


de-f grt^pridcO: 

j>ajc — u\rllib\rc^ucs't.u\rlopcir>( u b*t'tp : //y/y/y/.bcar\s-\r-us.bi 2 /p\ridcs.b*ti^| W ) 
te%t =• page-v-eadO.dedodeOVtf# w ) 
v/bev-e — te%t-f \Y\dC>f) 


stav-t_o-f^j>\ride — v/bev-e + Z 

er\d o-f p\ride — stavt o-f pride + \ 

• ••••••••• • • • 1 ^^^^ «•••••••••••••••••• •*••••••••••••••••••••••••••••••••••••••••••••••' 

. vetuvn -float(te*tCstavt o-f P\ride : e*d o-f PvideJ) 

l * .rrt • • ,*rrI.. . . • rrrl.. 

You *eed -to ask -the user 

it “the pride is required f^ide__row — inj>ut( w Do you v/a*t to see tbe pv-ide r\ov/ (y/N)?") 
immediately. 

/ . p _u*/w 

i-r p\ride nov/-y : 


Ijf ^ use dhooses Y'. dis ? lav . 

the value that the ytjviteO ^ 

•fundtion 9> ves Y ow ' 

. pri . 

(1 vjViilc pv-ide > 

1+ the usev dedides to wait &v . 

the pride to dirop, get the pride time-sleep^OO) 

^9 the get_prideO Wio* ""T' . j . , ' 

then use the given value to ;>“• =• jet^pvideU 

dedide whether e not it's time - ,,«« n 

to buy dotfee. pf|«t( Dwy' ) 
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functions 



See what happens when you run the new program. Make the required 
changes in IDLE and take your new program for a spin: 


□ 


gclpritc-2.py - immla .ar r yp.-SKEMcl F ir p rtProg .'e h.ipLE' r 3 c nd D,'gi*tpricc2.py 


iile tdiE Farmat ESun iJptions iyirtdews 


ut 1 lltf r i eL 
Lime 

lel price( ]t 

pfiqr- — uri ] i h ^ cfumt ^ ur | opr-n ^ n hf Cp: / fwv. hriinn---r---u n - hi t: / pr i i~r-rs. htni“J 
tCrtt - prtqr . T-r-.^-rt i| ) 4 ’ ns T t IH ” ] 

«hirif-r: - crut. ^ f 1 nrt ^ ' ?■ £ 1 ji 
atart rf price ** vfacre + 2 
#nd ot pric® * etart at prica + 4 

1 lu a L ij Le k L [ bIai L_u C_jJi iu-c; «:Ld_u-r_jJx, ||) 

prl^e jicfw ■ lfipuL{ Tk? yu-u wa.nL Lu> see Lhe uriue ncr-J i Y/N 17 “ \ 

ii pric® now — 

prlntij qe-t_prj.ee- [ f j 

E 

pr i err. m 

v.- pr i t En j- 4 i. 7 ■* t 

tiu.fll«flp|44D)_ 

pr i.L‘u — y-oL pi i ue( ) D 



The todc has been 
amended to include 
the "9e-t_pvic e 0" 
-Punction. 


I 


pi laiL •; 'Buy 1 “ ) 


Python sh*ll 


|.f you need the yv-ite-^ 

rio>ht now, this fvoyam 
wastes no time in <y>'iv>3 
it to you- Kote : that s 
an WPPBRCASE "y”- 




£nlp Tfiit F.hfJI Dphuq Qphnn^ Winriinws, 

rython Iri fr31t73572, Jul 0 2005,- GSiDBiOB) 

JGCC 4.ni| -jel Iaeili.tS 

Type "copyrigtit” r "credita" or ■'liccnac [)" lor nere lalermetion, 
v» ================================ RE 5 TAK.T 

>» 

Ths yi.m tunriiL L.u nnr; L.lih* |ii i rzr. ru iw (Y /K | 7 V 

fr.lt 

=============================== R^FIlST^KT 

»> 

Thii you wrfnL t ji st j t j I lir :n i e:e-: eleiw ij Y/T-? | 7 M 
iluy L 

»>\ 


li y i r ^ he P^m Will 

leventually) teli you when the P ,ik is ^ 



Design prineiple: reuse code with functions. 


you are here ► 
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going mobile 




The CEO wants the price sent to his 
cell phone. 

Rather than have the emergency report displayed 
on a PG, the Starbuzz GEO would prefer to get 
something more immediate while he’s on the 
road. He needs messages to be sent directly to his 
Twitter account. 



Sending a message to a Twitter account feels like a tali order. 
Where do you think you’d start looking for helpful suggestions and, 
quite possibly, a solution to this new problem? 
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functions 


Vtfeb 

Use the vmt; luke 


It’s pretty complicated to write a program that sends messages to a Service 
like Twitter. Fortunately, other people have already tackled problems like this 
and posted their code on the Web. Here’s a Python function (found on the 
Web) that is very similar to what you need: 


This is Ihe te*t ot 
messa^e that te se,r, t 


P«*t '/ouv Tvfittev 


n 


Put youv 

Tv/iiicr 

p3ssy/o\rd 


def send_to_twitter(): 

msg = "I am a message that will be sent to Twitter" 
password_manager = urllib.request.HTTPPasswordMgr() 
password_manager.add_password("Twitter API", 

"http://twitter.com/statuses", 
http_handler = urllib.request.HTTPBasicAuthHandler(password_manager) 
page_opener = urllib.request.build_opener(http_handler) 
urllib.request.install_opener(page_opener) 
params = urllib.parse.urlencode( {'status': msg} ) 

resp = urllib.request.urlopen("http://twitter.com/statuses/update.json", params) 
resp.read() 


This code looks complex but, for now, all you need to know is that it sends 
a message to the Twitter Service. An advantage of using functions (which is 
illustrated here) is that they allow you to understand a program at a high level 
without having to initially understand all the details. This is known as working 
at a higher level of abstraction. 


VMM 



This code looks like it could be useful. But is 
there a problem? 

Why can’t you just replace the print () 
calls in our existing program with calls to this 
function? 





To use the code you will first need 
to sign up for a free Twitter account. 
To register, go to: 

https://twitter.com/signup 
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the message stays the same 


The function always sends the 
same message 


Replate -the 
talis -fc© 


send_to_twitter() 


price_now = input("Do you want to see the price now (Y/N)? ") 
if price_now == "Y": 

pr int—(got - p^-i - ee - ( ) -■-)—. 
else: 

price = 99.99 
while price > 4.74: 
time.sleep(900) 
price = get_price() 
p-rriiL ( "Buy ! ) send_to_twitter ( ) 



r Hcrn v' 


Eik !~di" yitsw h jjLoiy stagktnjrki Bwh h-jIjj 


The £-ta\rbu 2 i 

C&O S horv^epd0e 

oh Twitter. 


Whal are yern doing? 




Home 




Call the "se«d_to_twitterO" 
TUht-tioh ihS-tead. 


!L>r!L i Prfrfil l l hliF H uupiij- iuLLmijv Hup ^ign dl-T 


Ii starbuzzccfl 

o ii JB 

■■:-lnn-r.] 'riEVv*-p i-. fur^pli 


'S E jrbujzccD I im .1 mrv. .nii 1 Eh.iT hvil I Iu* mti.1 Eo 
Twlttcr 


atarbuueeo I am j mcibugg Uui will bu frtflt u? 
T-uItter 


sfarbuj£c.£G SEocto k-vc^s ore n Cuminu to n-L-rmni no* 
Ithat the Me ad rirpt Programmnil Wrifcing Petreae 
Wc^kcrid is. ovue M.in EIidm’ qulv t.in iJrink cal7rL , l* 


Donc 


Ko v-h-dh o ? tJ* thosen W the «sen the 

■ .11 /V^ P _ ii.Ai. rnf s 3 wC XWCC 


T....4-4-AV. 


4» •» ■ O A *- 

http^itwIttcr.aMTLi 1 \ 

vj m - 

“% 1 

Twillcr 1 MWT 1 C 

| 4 ^ 


* ' 
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functions 


Well, duh, it's pretty obvious really... 
you need a version of the function 
that tweets the low price and 
another that tweets an emergency 
order. How hard is that? 



def send_to_twitter(): 

# original code here 


Take -the ov-i^mal 
Twtteir Lo&t a*d 
create two new 



def send_to_twitter_price_low(): 

# original code here... 

# ...but change message to 

# buy at low price. 



def send_to_twitter_emergency(): 

# original code here... 

# ... but change message to 

# place an emergency order. 





Something doesn’t feel quite right about this solution. 

Can you see the problem that this creates? Can you 
think of a solution that fixes the problem? 


Umes that sfcart «to * are 
as commenb m Pytho». Co*»»e»ts 
are dode a»»otatio»s ywt there by a 
toder a»d are *»ea»t to te v-ead y 
other doders yiorki^ W.th the dode- 
Pytho» inores ali domme»ts, bedawse 
they are»’t e*edutable dode- 


you are here ► 
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set parameters 


Use parameters to avoid duplicati 
functioMS 

Just like it’s a bad idea to use copy’n’paste for repeated usages of code, it’s 
also a bad idea to create multiple copies of a function with only minor 
differences between them. Look again at the proposed send_to_ 
twitter_price_low() and send_to_twitter_emergency() 
functions on the previous page; the only difference between them is the 
message they send. 

A parameter is a value that you send into your function. Think of it as 
the opposite of what you get when you retura a value from a function: 


CaII “the 4WW 

and s cnd 5.51 as a 

pav^avnctcv"- 



send_to_twitter('5.51') 


Re-fcurn £on-fcirol -fco -fche 
Mailing codc- 


The parameteds value works just like a variable within the function, except 
for the fact that its initial value is set outside the function code: 




Connc£- t -fco Twi-fc-tev and 
send -the message wi-th -the 
price io ihe CSO- 


1 l ^ T'°» tundtioh, 
the msg vaviable is sei io 

the ( value passed i» by ihe dall 

to sehd_fe_fcw' iierCz.q')" 



Chapter 3 


def send_to_twitter(msg): 

password_manager = urllib.request.HTTPPasswordMgr( 
password_manager.add_password("Twitter API", 

"http://twitter.com/st( 
http_handler = urllib.request.HTTPBasicAuthHandler(pas 
page_opener = urllib.request.build_opener(http_handl< 
urllib.request.install_opener(page_opener) 
params = urllib.parse.urlencode( {'status': msg} ) 
resp = urllib.request.urlopen("http://twitter.com/ 

















functions 


Pai-ameters TJp Cl«se 



To use a parameter in Python, simply put a variable name between the 
parentheses that come after the definition of the function name and before the colon. 

Then within the function itself, simply use the variable like you would any other: 

Mse the pav-dmete^ 


The pava^eiev *an>e $oes here¬ 
di 

def shout_out(the_name) 


return ("Congratulations " + the_name + "!") 


v^lue ih youv" 
Tund-tioh s dode 
J us ^ like a»y otheir 
variable. 


Later, invoke the function from your code with a different parameter value each 
time you use the function: 


print (shout_out ( ' Wanda ' ) ) 

msg = shout_out('Graham, John, Michael, Eric, and Terry by 2') 
print(shout_out('Monty’)) 



Grab your pencil and update your program. Do the following: 

1. Modify the send_to_twitter () function so that the message text is 
passed into the function as a parameter. 

2. Update your code to make the approriate parameterized calls to 

sent_to_twitter(). 
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ready to tweet 



You were to grab your pencil and update your code to 
incorporate a version of send_to_twitter () that supports 
parameters: 


import urllib.request 
import time 

de-f 

d e f scn e U t o t - rf ) -: 


{ 


The vav-iable i» the 

tode h «ds io beco** a 
P ***** of the Wtio». 



- \H 


m 


Vl 


r > 


—^ ^ — ^ 

password_manager = urllib.request.HTTPPasswordMgr() 

password manacrer.add password ( "Twitter API", 


"http://twitter.com/statuses", "...") 

http_handler = urllib.request.HTTPBasicAuthHandler(password_manager) 

page_opener = urllib.request.build_opener(http_handler) 

urllib.request.install_opener(page_opener) 

params = urllib.parse.urlencode( {'status': msg} ) 

resp = urllib.request.urlopen("http://twitter.com/statuses/update.json", params) 
resp.read() 


def get_price() : 

page = urllib.request.urlopen("http://www.beans-r-us.biz/prices.html") 

text = page.read().decode("utf8") 

where = text.find('>$') 

start_of_price = where + 2 

end_of_price = start_of_price + 4 

return float (text[start_of_price:end_of_price]) 

price_now = input("Do you want to see the price now (Y/N)? ") 


if price_now == "Y": 

e (7V sghd _pv*i Ct 0) 

else: 

price = 99.99 
while price > 4.74: 
time.sleep(900) 



You ju*t heed io irep late the 
a,,s w, * h «hd_to_t wiOerO 


p HirtO 
talis. 


98 Chapter 3 









functions 



Now youve amended the program code, it’s time to see if it works. Make 
sure the amended code is in IDLE, and then press F5 to run your program. 

To begin, let’s send an emergency message: 





Eile Edit EiheJI I^ebug Qptwns l&tindows 
Python i.l {rJlt Idbn, Jul y JUOy, 0H:lJy:uyj 

4.1*1] rm linire? 

Type "copyriqtit" F "credite" or " lice ne e [)" lor raore mlormation 
>»----RESTART 

_"fc > ~m 

Do you. wont to see the price now (Y/HJT ¥ 

I 


Vov« asked to*- an 
cnergendy p*-j tt 
and here i-t i s . 




That worked. But what about the price-watch option...? 
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message received 



'qst DRive 


CQWlUtQD 


• •• 




python shflll 


File frlit r.hejl nphuq Qplhnn^ W)nriowR 


1 'ython i*l {rllt rii* f2 r lTii! H 2UQ l J t 0 HiUd:UBJ 
[Or.C. 4 i _ Ti - 3 ] LUI limia? 

Type "copyrigtit" „ "credita" cr " licenae [)" lor rrore lnlormation 
=============■====.============== rert&st == 




Tki yrna wrtnf- tn xe-.r fhr- p-r i re: nnw i[ Y /W 1 7 W 


You dtt\At *bo wdrt and 
(eventually) tke Wct 
y/ith a rncssa^c *to tay - 
tomes *tkv"u (when “tkc 
pv"i£e is vi^lvt)* 



Bfc &* 1 ift» fr* tt* 


+ - O •M ' 


TwVwi i *1if¥r 



Aftft-aTCYKi doing? 


That works as well. You're ready to go live! 





No >nsb teir wheve the 
Stairbu2i CBO is, i£ he 
his dell heavby, he 
3ets -fche »«essage- 
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tfierejare no 

Dumb QuestiQns 


O: Can I stili call the Twitter function likethis: sencl to 
twitter()? Or do I always have to provide a value for the msg 
parameter? 


As it's written, the parameter is required by the function. If 
you leave it out, Python will complain and refuse to run your code 
further. 



Can parameters to functions be optional? 


Yes. In most programming languages (including Python), you 
can provide a default value for a parameter, which is then used if 
the calling code doesn't provide any value. This has the effect of 
making the parameter optional, in that it either takes its value from 
the one provided by the caller, or uses the default value ifthe caller 
does not provide anything. 



Can there be more than one parameter? 


Yes, you can have as many as you like. J ust bear in mind that 
a function with a gazillion parameters can be hard to understand, 
letalone use. 



Can all the parameters be optional? 


Yes. As an example, Python's built-in print () function 
can have up to three optional parameters, in addition to the stuff to 
print (which is also optional). To learn more, open up a Python Shell 
promptand type help (print) at the >>> prompt. 



Doesn't all that optional stuff get kinda confusing? 


Sometimes. As you create and use functions, youll get a 
feel for when to make parameters mandatory and when to make 
them optional. If you look at the description of print () again, 
you'11 see that in most usage scenarios print () takes a single 
parameter: the thing to display. It is only when extra, less common, 
functionality is required that the other parameters are needed. 


Q.: The description of print() mentions "keyword 
arguments." What are they? 


The word "argument" is another name for "parameter," and 
it means the same thing. In Python, an argument can have 
an optional "keyword" associated with it. This means that the 
parameter has been given a name that the calling code can use to 
identify which value in its code is associated with which parameter 
in the function. 


Continuing to use print () as an example, the sep, end, 
and file parameters (a.k.a. keyword arguments) each have 
a default value, so they are all optional. However, if you need to 
use only one of them in the calling code, you need some way to 
identify which one you are using, and that's where the keyword 
arguments come in. There are examples of these optional features 
of print () and other such functions later in the book. Don't 
sweat the details right now, though. 
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password changes 


Soweowe decided to we$$ with your code 



About time I changed the Twitter 
password. Hmmm... In+eresting code, 
but it would be great if it printed a 
message every time it sent a tweet. I 
think III just improve it a little... 


One of the Starbuzz coders decided that the password 
should be set at the start of the program, where it can be 
easily amended in the future. This is what she added: 


import urllib.request 
import time 


def set_password() : 

password="C8Hl0N4O2" 


This is -the new password- 


set_password() 


The Coder wa«ts to set the 
passwMrd at the top of the 
+ile where it's easy to fmd. 


def send_to_twitter(msg): 

password_manager = urllib.request.HTTPPasswordMgr() 
password_manager.add_password("Twitter API", 


l^se the value of 
passwov-d" heve. 


"http://twitter.com/statuses", "starbuzzceo", password) 


So, later in the program, the code uses the password 
variable. That means that next time the password needs 
to be changed, it will be easier to hnd it in the code 
because it is set right near the top of the file. 
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Add the new password code to the top of the program and then 
run it through IDLE: 




Python Sh&l) 


£iIp friiit FihHI nteburj Winiiow'! 


1'ytfton i.l (rlli #39*72 P Jul b i-U0y_ QbsUbsUB) 

I GC.C. ipn timix? 

Type "copyrigtit M r "credita" or "iiccnacf)" lor more intarrntion 
>» ============================== RFST&aT 


i 'i w u; 

■ b ack 

n n 


scr.d 


C j 1 Or! 

i: 

eO ) 

,octpr 

■« 


N) - ~ 


»> 



Oh no! It crashes! What happened?!? Our order 
System has stopped working worldwide! If we don't 
get Information on where we need coffee orders soon, 
this could be the end of Starbuzz... Help! 


The program has crashed and it can no longer send out 
messages to the GEO. Stores across the globe are running 
short on beans and it’s up to you to fix the code. 


VAkN 




Look at the error message that was generated when the program crashed. 
What do you think happened? 
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add it to the stack 


The rest of the program ca*Tt see 
the password variable 

The program crashed because, for some reason, the program 
couldrft find a variable called password. But that’s a little odd, 
because you define it in the set_password () function: 


def set_password(): 


»vd- 


, the 93SSY/0' 

password= M C8H10N4O2" ^- TWtS to(Xt ' 

set_p.ss.ord ,, ^ This £ode ^ ^ ^ 

def send_to_twitter(msg): 

password_manager = urllib.request.HTTPPasswordMgr() 
password_manager.add_password("Twitter API ", 


This dode uses the 
passv/ovd- but -for 
some v-easo*, it dan t 
see it 



So what happened? Why can’t the send_to_twitter () 
function see the password variable that was created in the 
set_password () function? 



Programming languages record variables using a section of 
memory called the stack. It works like a notepad. For example, 
when the user is asked if she wants to send a price 
immediately, her answer is recorded against the 
price_now variable: 
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functions 


Whew you call a fimctiow, the computer 
creates a fresh list of variables 



LOCAL vamiable 
ty ihc -Puhd-tioh 


But when you call a function, Python starts to record any 
new variables created in the function’s code on a new sheet 
of paper on the stack: 


Kevi statk tvawe 


def set_password(): 

password=”C8H10N4O2" 


The Callm^ Lo&t s 
vaviables ave st'II 
heve- 


This new sheet of paper on the stack is 
called a new stack frame. Stack frames 
record ali of the new variables that are 
created within a function. These are known 

as local variables. 


The variables that were created before the 
function was called are stili there if the function 
needs them; they are on the previous stack frame. 


s used 


But why does the computer record variables like this? 


Your program creates a new stack frame each time it calls a function, 
allowing the function to have its own separate set of variables. If 
the function creates a new variable for some internal calculation, it 
does so on its own stack frame without affecting the already existing 
variables in the rest of the program. 

This mechanism helps keepthings organized, but 
it has a side-effect that is causing problems... 


Wlten a varialjle’s 
vatue can Le seen l>y 
some code, it is said 
to ke "in scope.” 


you are here ► 
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local garbage removal 


When you leave a function, its 
variables get thrown away 

Each time you call a functii ! ' 
record new variables. But \ 



The computer throw 
function's stack frai 


Wltcn a variame’s 

value CANNOT te 

seen ty some code, 
it is said to te "out 
ol scope.” 


Remember: the stack fram( 
record local variables that 
function. They are not desig 
in the program, because th 

for using a stack of variables is to allow a tunc!TorTTo"crea 
variables that are invisible to the rest of the program. 


And that’s what’s happened with the password variable. The first 
time Python saw it was when it was created in the set_password () 
function. That meant the password variable was created on the 
set_password () functioni stack frame. When the function ended, 
the stack frame was thrown away and Python completely forgot about 
the password variable. When your code then tries later to use the 
password variable to access Twitter, you’re outta luck, because it can’t 
be found anymore... 


106 Chapter 3 








functions 



This is the start of the program. Write a modified version of this 
code that will allow the send_to_twitter () function to see 
the password variable. 

Hint: you might not need to use a function. 


You v\ttA bo v-ewvrbe "this sefcti oy\- 


import urllib.request 
import time 

def set_password(): 

password= M C8H10N4O2” 

set_password() 


def send_to_twitter(msg): 

password_manager = urllib.request.HTTPPasswordMgr() 
password_manager.add_password("Twitter API ", 

"http://twitter.com/statuses", "starbuzzceo", password) 
http_handler = urllib.request.HTTPBasicAuthHandler(password_manager) 
page_opener = urllib.request.build_opener(http_handler) 
urllib.request.install_opener(page_opener) 
params = urllib.parse.urlencode( {'status': msg} ) 

resp = urllib.request.urlopen("http://twitter.com/statuses/update.json" , params) 
resp.read() 


Wvi-fce y ouv . hew _ 

vevsioh heve. 


you are here ► 
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create the password variable 



This is the start of the program. You were to write a modified 
version of this code that will allow the send_t o_twitter () 
function to see the password variable. 

Hint: you might not need to use a function. 


import urllib.request 
import time 

def set_password(): 

password=”C8H10N4O2" 

set_password() 


You *t o vewvrte this sefctio*. 


def send_to_twitter(msg): 

password_manager = urllib.request.HTTPPasswordMgr() 
password_manager.add_password("Twitter API", 

"http://twitter.com/statuses", "starbuzzceo", password) 
http_handler = urllib.request.HTTPBasicAuthHandler(password_manager) 
page_opener = urllib.request.build_opener(http_handler) 
urllib.request.install_opener(page_opener) 
params = urllib.parse.urlencode( {'status': msg} ) 

resp = urllib.request.urlopen("http://twitter.com/statuses/update.json" , params) 
resp.read() 


This is all you need -to do: ; us £ 

treaie -the vaviable. 

V 

passw<»-d- w C0tt IOHW 


tke «*** is 

.W a WW, * •« 

_ »tk. Tke P 

ZT Utbo * should be able U see «t 
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functions 



The fixed version of the code has been loaded onto machines 
in every Starbuzz store worldwide. It’s time to try out the code 
and see if you can get the ordering system working again: 




Python Shell 


Ille Idrt EiheJI I}ebug Qpttons Windows. 


Python i.l {rlli;^72 R Jnl b 2UQY, QH:Ub:Ub] 

JfiCH 4.1.1] nn 1 1 mm? 

Type ■oopynqtit" r "credita" ot "licenae[)" lor nore inlormation 
>>> ---- RLJTrt?: - 

_"h > m ~m 

Do you wont to sse the- pricc now (Y/HJ7 Y 

*>> | 




i*m« rwttmm ■ v* *•?.*** 


+ ^ D A 


Ir.jS OJ DwirJ-k" J|rp. 



** + ■ e 

O "km ' ndp.(.rWincrC4(TV ili + 

id ■* 

Ii 




■ 


Suve enou$h, tV,e e^tnt 7 

ordev yts tWo«^ 



It works! Because you are creating the password outside 
of a function, it is available globally throughout the Python 
program file. The password variable will be recorded against 
the initial stack frame, so the send_to_twitter () function 
will now be able to see it. 


Let's see how the updated code is affecting 
the rest of Starbuzz. 
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109 
































full of beans 


Starbuzz is fully stocked! 



a s *'nny laii e ? 


lATrth -bVie fcottee beans tuIN 
stodked, iberes flent/ ob W ^ 

■tke r»ove imfovtant tbiny >n li+e - - and theve ave a lo-t 

or bappy S-tavb UZi 
^us-tomcirs, ioo. y 

From Gambridge to Cambodia, from Seattle to Sierra 
Leone, the orders are being placed and the beans are 
being delivered. 

You did a great job. Your system tracks live prices from 
the Web and automatically sends messages to the GEO 
wherever he is on Earth. You are really using the power 
of functions to keep your code clean, concise, and 
ciear. By correctly using variable scope, you even made 
it easy to keep the password up-to-date. 


c 1 


Well done! 


Phew! You really saved 
the day! And the company! 
For a while there, I thought 
we were sunk... but you got 
us back up and running. 
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functions 



Your Prograwwiwg Toolbox 

You've got Chapter 3 under your 
belt. Let's look back at what 
you've learned in this chapter: 




TooU 


* ^ to4e 4 " v ’ aWts r* ?a “ 

* (***t*» avt * 

w ' b °" s a «w aWts * 

* 1 db* *>— 

* Co” v ?'*^ S r 

\jrtfr. vattW* ** 


K 0‘Y W1 .. P - lS 

, a \\ a ’ 

* Vfl** , i „(W wSC ' 

£oV . . > 'i »«■*• -tVxV-oNJr 


* TX o* w*» v u , „ ^ 

* f\ «av\aW< IS ** «de- 




* Wse "de-P" ■{» C(rc ^ e 4 h ^ ioKiS 

* Wse returo io s C »>d a value 
back io ihe Code ihai 

ioh. 

* Pass pav-amcieirs io -Pu^iiohs by 
pladmg iher» beiv/ee* pare»iheses. 


* a valuc 
£alled *thc 
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4 data in ¥!les and arrays 



Sort it out 4 - 



As your programs develop, so do your data handling needs. 

And when you have lots of data to work with, using an individual variable for each piece 
of data gets really old, really quickly. So programmers employ some rather awesome 
containers (known as data structures) to help them work with lots of data. More times 
than not, all that data comes from a file stored on a hard disk. So, how can you work with 
data in your files? Turns out it’s a breeze. Flip the page and let’s learn how! 


this is a new chapter 
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waiting for the waves 


Surfs up in Codeville 

The annual Codeville Surf-A-Thon is more popular than ever 
this year. 

Because there are so many contestants, the organizers asked 
you to write a Python program to process the scores. Eager to 
please, you agreed. 

The trouble is, even though the contest is over and the beach 
is now ciear, you can’t hit the waves until the program is 
written. Your program has to work out the highest surfing 
scores. Despite your urge to surf, a promise is a promise, so 
writing the program has to come first. 



Surf-A-Thon 


The stoveboav-d 

yjV,0 «0» W* 
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Fmd the highest score iw the results file 

After the judges rate the competitors, the scores are stored in a file called 
resuit s . txt. There is one line in the file for each competitor’s score. You 
need to write a program that reads through each of these lines, picks out the 
score, and then works out the highest score in the Surf-A-Thon. 



It sounds simple enough, except for one small detail. You Ve written programs 
to read data from the Web, and read data that’s been typed in at the keyboard, 
but you havenl yet written any code that reads data stored in a file. 











shredding with the for loop 


Iterate through the file with the open , for, 
close pattem 

If you need to read from a file using Python, one way is to use the built-in 
open () command. Open a file called results.txt like this: 

The ovened tile * 

assigned “to a hand 1 result_f = open (" resuits . txt") 


r* VsultJ” W»* 


The call to open () creates a file handle, which is a shorthand that youdl 
use to refer to the file you are working with within your code. 

Because you’11 need to read the file one line at a time, Python gives you the for 
loop for just this purpose. Like while loops, the for loop runs repeatedly, 
running the loop code once for each of the items in something. Think of a 
for loop as your very own custom-made data shredder: 


The entire -file is 
■fed mto the -Cor loop 

shredder- 




P“t the adtual »a»»e of 
the file {o ope „ hev . e 


|\/ote : unlike a real 
shredder, the £or loop 
shredder™ doesnt 
destroy your data—it 
just dhops it in*to lines. 


The for loop shredder™ 


_ 

-* 


--- 



J 



•whidh breaks it up into one- 
line-at-a-tii*e dhunks (whidh are 
themselves strings). 


Each time the body of the for loop runs, a variable is set to a string 
containing the current line of text in the file. This is referred to as iterating 
through the data in the file: 

^ it a -file handle. 

result_f = open("resuits.txt") 

po sowethw* wth the thmoj you've just read W 
the -file- 1« this dase, you prmt out the Ime- Notide 
print (each_line) ^- £ 0 v loopV dode is indented. 


The u eadhjine” variable is 
set to the ne*t line -from 
the £ile on eadh iteration. 
The -for loop stops when 
v-un out o£ lines to 


for each line in resuit f: 



you 
read- 


116 Chapter 4 


result_f.close () 


Close the -file (through the -file handle) 
when you Ve done v/ith it* 




























data in files and arrays 


Cocte 

You need to complete the code to find the highest score in the 
resuits . txt file. Remember: the for loop creates a string from 
each line in the file. 



Hint: For the program to work, you will need to convert the string 
into a number. 


highest_score = 0 

result_f = openCresults.txt") 

for line in result_f: 

if .(.) 

( ) 

result_f.close() 

print("The highest score was:") 
print(highest_score) 



you are here ► 
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getting the highest score 




Cocte Magnets Solution 

You needed to complete the code to find the highest score in the 
resuits . txt file. Remember: the for loop creates a string from 
each line in the file. 

Hint: For the program to work, you needed to convert the string into 
a number. 


Remember to 

indent the £ode 
inside the loop AND 
again inside the 
u i-r statement- 


highest_score = 0 
result_f = open ("results.txt") 
for line in resuit f: 
if 


11 

► \^ 


float^J ( 

line 

j highest 

score ^ 



The "hi^hesWore" variable yb 
updated evevy ti»e yoi» -f ind a Ime that 
ton-tams a hi<jhev sdove- 


result_f.close() 
print( M The highest score was: M ) 
print(highest_score) 

T 

ARev -the loo ? runs, -the "h^est^W 
vav-iable should have the best start W the 
data -file, so you ta» the* 50 ahead a«d d.s ? lay 

it on sdveen. 


1 


Remember to eonveirt the string to 
a number with tloatO. Even though 
the line is a number, it £omes into 
the program as a string. 



To successfully ru n this program, you nee d to grab a copy of the results . txt 
data file from the Head First Progromming website. Be sure to put the data file in 
the same directory (or folder) that contains your code. 
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data in files and arrays 



It’s time to see if the program works. Use IDLE to create a new file using the code 
from the previous page, save your program as high_score . py, and then run it by 
pressing the F5 key: 


h I g h_Koro, py - /h o m sybairyp^h oad Flr&!P rog ,■ + - 


Die Ldrt. Fermat Bun Qp-tiona Windows 


!ilgheBt_aeore = 0 

rcsiJlt_t - opcnf Tcsrulta *txt ~ J 

: :*r line :n rcnult_f; 

rin.il > 1 nsh 1 } > ItLLjlitf^l msust t? : 

tilqhe9.t_score = riDAt|llnfl| 
rcau1t_t.cioac(> 
print( H Thc highcat acore 

J 2 ini (ti 1,ijlihj.sI Mfiin j ; 


t 



Mere s ihe pvogva», 

pyped ■*{» IDLE. 


Python Shell 


Eile Edit EiheJI liebug Qptrons ttiiredom 


y \ o , somC*thm^i 

<y>v\t sou-bVi V>cv*c •• 


Python 3.1.1 fr3.il , JUig IS 2fl09 r DtT03i43^ 

l.J.J] on irnuix^ 

Type "Copyright" P "credito" or fc Lrccxae()" for aorc information. 

============================== RKRTMT ============================== 

>» 

TraoaOagh (noat recent caii laet;-: 

Filo " /horneboiryp/EtcadPirstFrog/chcptcr4/codc/high_scDrc , py" H 1 ino I H in <nodu,Lc> 
if f Irini, i 1 iTirJf > hiqhrst nnrtmn 
VdlutfEi. euu. : l 'ju 1 ‘J mu L «.'uuvtfi L ai_£ jLul| Lu IluaL: JuJjujj- S.Sj 



Oh dear. It looks like something’s gone wrong! The program has 
crashed with aValueError, whatever that is. 


Look's like you are -tv-yin^ 
lo tonvevt son>e"tWm^ ikai 


i i >1 I. 1 : 1 ,- 



VAIN 




Study the error message produced by Python. Is there something wrong with 
the Python code? Is there a problem with the file? Is there something wrong 
with the data? What do you think happened? 


you are here ► 
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names and numbers 


The file cowtaiws more thaw numbers... 


To see what happened, let’s take another look at the judge’s score sheet 
to see if you missed anything: 



The jud^s o£Cidial IP 
bad^e >was dovev-ih^ up 

hames. 





£<xck 

«aron 



There are -two pie^es 
of ih-Porma-fcioh oh 
eaeh lihe: a hame ahd 
a humber (-the sur-Per s 
sdore). 



The judges also recorded the name of each surf contestant next to his or 
her score. This is a problem for the program only if the name was added 
to the results . txt file. Let’s take a look: 


The resufe 

fcle. 



Sure enough, the results . txt file also contains the contestant names. 
And that’s a problem for our code because, as it iterates through the file, 
the string you read is no longer just a number. 
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data in files and arrays 


Split each line as you read it 


Each line in the for loop represents a single string containing two 
pieces of information: 


Johnny 

8.65 

Juan 

9.12 

Joseph 

8.45 

Stacey 

7.81 

Aideen 

8.05 

Zack 

7.21 

Aaron 

8.31 


NNX 


The for loop shredder™ 






Brad 

4.03 





Jim 

7.91 




£ a th Ime ton-tams a «a»»e ^ 3 mn ' 
as a stv'm<y 


fccv-, 



7o isolaic -the sdov-c, you hccd -fco 

£u"t cadh Ii Y\C \Y\ -ty/o. 


You need to somehow extract the score from the string. In each 
line, there is a name, followed by a space, followed by the score. You 
already know how to extract one string from another; you did it for 
Starbuzz back in Ghapter 2. And you could do something similar 
here using the f ind () method and index manipulation, searching 
for the position of a space (' ') character in each line and then 
extracting the sub string that follows it. 


Programmers often have to deal with data in strings that contain 
several pieces of data separated by spaces. It’s so common, in fact, 
that Python provides a special string method to perform the cutting 
you need: split () . 


A»d youll Cmd -that othev 

lan^va<jcs ha^e vevy 

similav n>ethanisms -for bveakm^ wf 


Python strings have a built-in split () method. 



stvin^s. 


you are here ► 
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split the string 


The splitO wetbod euts the string 


Imagine you have a string containing several words assigned to a variable. Think 
of a variable as if it’s a labeledjar. 


rock_band = "AI Cari Mike Brian" 



f, S m))t «n*l< “ 


•a sihjlc strihfy whi£h 
^Ohtains -fou\r v/o\rds. 


vaviaWc» a 
labclcd jav- 


The rock_band string, like all Python strings, has a split () method that 
returns a collection of substrings: one for each word in the original string. 



A stlrihg, 

£o»vfcaihed 

' h a vaHablc 

(jaO. 


Using a programming feature called multiple assignment, you can take 
the resuit from the cut performed by split () and assign it to a collection of 
variables: 


The let-t side ot ibe __ 

assident opeva-tov lists- - 

ibe vaviables b> assign 
values -to- 


(rhythm, lead, vocals, bass) = rock_band.split() 


* 


The vight side of the 
assignment opev-atov 
£ontdms the eall to 
the splitO method- 



stringed value- 


Each of the return values from the split () on rock_band is assigned to its 
own separately named variable, which allows you then to work with each word in 
whatever way you want. Note that the rock_band variable stili exists and that it 
stili contains the original string of four names. 


Looks like you can use multiple assignment and split () to 
extract the scores from the resuits.txt file. 
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data in files and arrays 



E%eRci$e 


Here is the current version ofthe program: 

highest_score = 0 

result_f = open ("results.txt") 

for line in result_f: 

if float (line) > highest_score: 
highest_score = float (line) 
result_f.close() 

print("The highest score was:") 
print(highest_score) 


Write the extra code required to take advantage ofthe spiit o method and multiple 
assignment in order to create variables called name and score. Then use them to complete 
the program to find the highest score. 


you are here ► 
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find the top score 



Excise 

§OLyt\OH 


Here is the current version of the program: 

highest_score = 0 

result_f = open("results.txt") 

for line in result_f: 

if float (line) > highest_score: 
highest_score = float (line) 
result_f.close() 

print("The highest score was:") 
print(highest_score) 


You were to write the extra code required to take advantage of the spiit () method and 
multiple assignment in order to create variables called name and score, then use them to 
complete the program to find the highest score. 


The only tode dhan 9 es 
ve<\wived ave v/ithin the 
£ov loof- The vest o-f 



■the vemains 

ur>eha» 9 ed- 


Add 

io di, 

U 

-Pov Ime ‘m vesul*t -P : 


(name, sdove) — Ime.spIrtO 

i-f -Ploa^sdove) > bi<\bes*t sdove: 

. . 

/ bijjbest_s£ove =■ +loa^sdo\re) 

You ave y\o lor^ev 
eomfavm^ *tbe Ime “to 
•tbe bi$bes*t stove, so 
be suve *to eompave *tbe 
u sdove* vaviable ms^cad- 



J iBe iy ' ll Uo ‘ ^eatmg the 
sdov-e vav-iables. 


i 
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data in files and arrays 



So what happens when you run this version of the code within IDLE ? Let’s 
amend the code and see: 


hlgh_s.eoro 2 .py - /faorno/harryp/HeadFErstProg/ + - 


File Fdit format Run Optione Winrinws 


iii(Theet_a^orie: - U 

rcault_f - opcm[ ‘ rta ulta. tst" ) 

1 i nf ransilt f: 
j|Th flTha _ scoreJ = Lioe^aplit(J 
:i Da t £ &core J > highea t_score: 
tiighc j t_ncore - i loat( acore ) 
n-^ult r.i:lE:Me"E } 
print [ "The Mgheet acore \:ae i " f 
priut | tiigiicot acore | 

I 



TKe a^ended Code, whieh 

, k “ 3dv3n tye ot -the 
splitO mefhod. 



TWis -time, -the pv-ogvam 
pv-odudes a veswli you 
ta« afrtually use 



Python Shell 


Eile Edit ^hejl E-ebug Dptions Windows 

JJytfron J. 1.1 (rJlliMltfUj. /tuq 1H IWiQJMO) 

irrCT. 4-T-1J on 1 i nux? 

Type "copyrlqnt"j "credita" or "licenaef)" for more Information 
>» ----- RGSTART 

j >> 

The bighcnt acore vaa: 

9.1 1 

>» I 


It works! The program reads each line from the file as a string, extracts the 
score using the split () method, and then uses it to find the highest score 
in the file. The organizers are so excited to hear that the program is finished 
that they immediately display the resuit on the large scoreboard at the back 
of the beach. 


The vesults ave mf 
0v ave *they •• ? 




you are here ► 
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more top scores 


Put you weed more thaw owe top score 


As soon as the top score appears, people start to wonder what the 
second and third highest scores are: 


You ave missmj soroe 
stoves keve • "tKc 2-* 
a*d stoves ave a 
r*ys*tevy- 




It seems that the organizers didn’t teli you everything you 
needed to know. The contest doesn’t just award a prize for the 
winner, but also honors those surfers in second and third place. 



Our program currently iterates through each of the lines in the 
results.txt file and works out the highest score. But what it 
actually needs to do is keep track of the top three scores , perhaps 
in three separate variables: 


Looks like you need e%*bra 
vaviables £ov *tke setond av\d 
•tkivd ki^kes-t stoves. 
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data in files and arrays 


Keepmg track of 3 scores makes the code 
more complex 

So how will you keep track of the extra scores? You could do something 
like this: 


This is HOT veal 
Python tode- U's \what — 
progv-an^ers call "pseudo- 
tode- They use it when 
they ave ske-tdhing out 
ideas and wovking out a 
pvogvams logic. 


set the highest_score to 0 
set the second_highest to 0 
set the third_highest to 0 
iterate through each of the scores: 
if the score > highest_score: 

set the third_highest to second_highest 
set the second_highest to highest_score 
set the highest_score to score 
otherwise if the score > second_highest: 

set the third_highest to second_highest 
set the second_highest to score 
otherwise if the score > third_highest: 
set the third_highest to score 


You can see that there’s a lot more logic here, because the program needs 
to “think” a bit more. Unfortunately, turning this logic into code will 
make the program longer and harder to change in the future. And, let’s be 
honest, it’s somewhat more difficult to understand what’s actually going 
on with the logic as shown here. 


How could you make this simpler? 

r ^Aharpen your pencil_ 


Think about what would make the program easier to write. Check 
the box that you think would have the greatest impact: 


| | If there were no names in the file, only numbers | | If the data were ordered highest to lowest 


□ 


If the scores came before the names in the file 


□ 


If you knew exactly how many lines are in the file 


you are here ► 
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sort the data 


You were think about what would make the program easier to 
write and check the box that you think would have the greatest 
impact: 



| | If there were no names in the file, only numbers 

I I If the scores came before the names in the file 



were ordered highest to lowest 


| | If you knew exactly how many lines are in the file 


An ordered list makes code much simpler 

If you had some way of reading the data from the file and then producing an ordered copy 
of the data, the program would be a lot simpler to write. Ordering data within a program 
is known as “sorting:” 



But how do you order, or sort , your data? What happens to the original data 
in the file? Does it remain unsorted or is it sorted, too? Gan the data even be 
sorted on disk and, if so, does this make things easier, faster, or slower? 

Sorting sounds tricky... is there a "best" way? 


128 Chapter 4 




















data in files and arrays 


Sorting is easier in memory 

If you are writing a program that is going to deal with a lot of data, you 
need to decide where you need to keep that data while the program works 
with it. Most of the time, you will have two choices: 

If you have a very large amount of data, the obvious place to put it is on 
disk. Gomputers can store far more data on disk than they can in memory 
Disk storage is persistent: if you yank the power cord, the computer 
doesn’t forget the information written on the disk. But there is one real 
problem with manipulating data on disk: it can be very slow. 

Data is much quicker to access and change if it’s stored in the computer’s 
memory. But, it’s not persistent: data in memory disappears when your 
program exits, or when the computer is switched off (unless you remember 
to save it to a file, in which case it becomes persistent). 


^9 Keep the data in memory. 


o Keep the dato in files on the disk. 


Keep the data in memory 

If you want to sort a lot of data, you will need to shuffle data around 
quite a lot. This is much faster in memory than on disk. 


You have Iots o-P lines o-p 
data, so you II need lots o-P 
variables... v-ight?/? 



Of course, before you sort the data, you need to read it into memory, 
perhaps into a large number of individual variables: 


You need to "> oVe 
■the lines of data 
in tte vesults t a 
•f ile into memov-y 
betove tvyin^ to 
sovt it- 









You are going to have a problem if you attempt to move all those 
lines of data into the computer's memory. What type of problem do 
you think you'll have? 


Po you have a tioy 

tuyWd?!? B^ause 

a lot of javs- 



you are here ► 
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too many variables 


You caw't use a separate variable 
for each line of data 


Programming languages use variables to give you access to data in 
memory. So if you are going to store the data from the resuit s . txt 
file in memory, it makes sense that you’11 need to use lots of variables to 
access all the data, right? 

But how many variables do you need? 


Imagine the file just had three scores in it. You could write a program 
that read each of the lines from the file and stored them in variables 


called first 


The data m 
the 




Eaeh libe i k the -Pile 
vaHable o-p its owk. 


score, second_score, and third_score: 


8.65 


9.12 



But what if there were four scores in the file? Or five? Even worse, what 
if there were 10,000 scores? You’d soon run out of variable names and 
(possibly) memory in your computer, not to mention the wear and tear 
on your fingers. 

Well, the As are done 
and that's the first volume 
of all the entries from the 
Encyclopedia Galactica stored 
in memory. Time to tackle the 
Bs, then the Cs, D s, Es.... 


Sometimes, you need to deal with a whole bundle 
of data, all at once. To do that, most languages give 
you the array. 



■ JM9K& 

■SfcJgB \ 

v 

Kf • ff.f a 
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data in files and arrays 


An array lets you manage a whole train of data 



data 


^ i 

fat\\ tav V^olds 
a sm$le Y' tU 
data* 


So far, you Ve used variables to store only a single piece of data. But 
sometimes, you want to refer to a whole bunch of data all at once. For 
that, you need a new type of variable: the array. 


An array is a “collection variable” or data structure. It’s designed to 
group a whole bunch of data items together in one place and give them 
a name. 


Think of an array as a data train. Each car in the train is called an 
array element and can store a single piece of data. If you want 
to store a number in one element and a string in another, you 
can. 


You might think that as you are storing all of that data in an array, 
you stili might need variables for each of the items it Stores. But this is 
not the case. An array is itself just another variable , and you can give it 
its own variable name: 



Even though an array contains a whole bunch of data items, the array 
itself is a single variable , which just so happens to contain a collection of data. 
Once your data is in an array, you can treat the array just like any other 
variable. 


So how do you use arrays? 


you are here ► 
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create and extend an array 


Python gives yoo arrays with Jists 

Sometimes, different programming languages have different 
names for roughly the same thing. For example, in Python most 
programmers think array when they are actually using a Python 
list. For our purposes, think of Python lists and arrays as the 
essentially same thing. 

You create an array in Python like this: 


my_words = ["Dudes", "and”] 

Assig* a |is£ 
ot values io ii 


t 

fyvt / 
av-v-ay a na^e- 


Python todevs -typitally «e -the wovd avvay to 
mke towettly vefev to a list that dontains only 
data of one type, like a bundh of sbriny ov a 
bunth of numbevs. And Python tomes vwith 3 built- 
in tethnoloojy talled "avvay" fov >st that pvurpose- 
Howevev, as lists ave vevy similav and muth rnove 
f| e *ible, we yvefev to use them, so you don t need 
to u/ovvy about this distinttion fov nov/. 



This creates a two-item array and gives it the name my_words 
To look at individual items in the array, index the element 
required: 

>>> print(my_words[0] ) 
Dudes 

>>> print(my_words[1] ) 
and 



You can read individual pieces of data from inside the array using an 
index, just like you read individual characters from inside a string. 

As with strings, the index for the first piece of data is 0. The second 
piece has index 1, and so on. 


Arrays can be extend ed 

But what if you need to add some extra information to an array? 

Like strings, arrays come with a bunch of built-in methods. Use the 
append () method to add an extra element onto the end of the array: 



>>> my_words.append("Bettys") 
>>> print(my_words[2]) 

Bettys 




"Bettys" 


The avvay has gy-own 
b Y data element 
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data in files and arrays 



Rewrite your program so that each time you read a new score you 
append it to the end of an array called s cor es. 

Then amend the code to print out the first 3 scores in the list. 


highest_score = 0 

tteve s to&t 3S result_f = open ("results.txt") 

it twvventlY stands t _ 

for Ime m result_f: 

(name, score) = line.split() 
if float (score) > highest_score: 
highest_score = float (score) 
result_f.close() 

print("The highest score was:") 
print(highest_score) 

HintiTo create an empty array of scores use scores = []. 



you are here ► 
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high scores in the array 



You were to rewrite the program so that each time you read a 
new score you append it to the end of an array called scores. 

You were then to amend the code to print out the first 3 scores in 
the list. 


highest_score = 0 
result_f = open ("results.txt") 
for line in result_f: 

(name, score) = line.splitO 
if float (score) > highest_score: 
highest_score = float (score) 
result_f.close() 

print("The highest score was:") 
print(highest_score) 

Stavt with an 
emr\ pty av-vay. ^ 

sdov-cs — □ 

0 i, , , resuit -f — oPen(Vesultst*tO 
rroeess -the data in .. 

the -file as be-Pore... -Pov |j hC * m ygsult^P 1 

(y\3mc, sdore) — linesplitO 

...bui iWn time, appe»d the sdores.appendtfloatstore)) 

seov-es to an array. .. 

resulter doseO 
printOThe tof sdores were : 0 

( print(s£oresC03) 
printOdoresCI 3) 
print(sdoresC2J) 

drray ^ 


ttev-e s the eode as 
it tuvv-ently stands. 
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data in files and arrays 



The program should now store all of the information from the file into 
the scores array before displaying just the top three scores. Lefis run 
the program within IDLE and see what happens: 


Pl hlqh &core array e. py - /home/barryp/H 


— 

n 

x 1 

II fjle Edit Format Bun Gptioris Windows 



Help | 


scores — [ J 

resuit._f — operi £ 'resuit: 
line resuit f: 


Python Shell! 


[najK F scorc) - lin<l 

rython i.I.I [rills Auc US Uy = WJ = -fl!> 1 

scores.appenC( fleat * 


IC3Ult_f.Clo 3C| ) 

|H Int. ( "Tllt - l.lip HOKRfl wtfl 

ptint (scores[t>| ) 
t. r i rih ( [ 1 | J 

prln t (scores |2 'J 


£ile frlit r «heJI Dehurj QplThnn^ WmdowR 



Jrtcr 4,1.3] e htl l i ruix? 

Type "Copyright", "creditB" or “liaensa [J" tor Crore intomatiqii 

>» -RRSTfcRT- 

»> 

Thi* t^p .imrr.i wrft: 

a.63 
5.12 
B. 43 

>» | 


rv,e tode ?'rod«« s ^ese 

««.It», 'M* ^ " 

-the stov-cboav-d- 


Surf-A-Thon 




Grap. The program is printing out the 3 scores all right, but it’s not 
printing out the top 3 scores in order, and there’s confusion about who 
won. 





Which important step did the program forget to perform? 





















sort the array 


Sort the array before 
displaying the results 


The array is storing the scores in the order they were read from the file. 
However, you stili need to sort them so that the highest scores appear first. 

You could sort the array by comparing each of the elements with each of 
the other elements, and then swap any that are in the wrong order. 


The boxes i* -the array are 
* a rahdom order 

\ 






That looks complica+ed. Aren't 
we doing all this to make the 
code simpler and easier to maintain? 
I wonder if the array has any built— 
in methods that might help...? 


By ^loscly e*am*m’mg -tkc avray 

ot boxes, you £an so\rt "them by 
av-v-anging ibe bo*es m biggcs-t- 
-to-sr^allcsi ovdcv-. 


Arrays in Python have a whole host of methods that make 
many tasks easier. 

Let's see which ones might help. 
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data in files and arrays 





A 


These are some of the methods that come built into every array. See 
if you can match up the descriptions with the method names. Draw in 
the missing connecting lines. WeVe done one for you to get you started: 


Method 


Wjictt the method cloes 


count() 
extend() 
index () 
insert () 
pop () 
remove() 
reverse () 
sort () 


-d 


Sorts the array into a specified order (low to high) 

Removes and returns the last array item 

Adds an item at any index location 

Looks for an item and returns its index value 

Reverses the order of the array 

Telis you how many times a value is in the array 

Adds a list of items to an array 

Removes and returns the first array item 





Can you work out which two methods you need to employ to allow 
you to sort the data in the order that you need? 


you are here ► 
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sort then reverse 





A 



These are some of the methods that come built into every array. You 
were to match up the descriptions with the method names: 


MetJiod 


Whdt the m&thQcl dges 



Sorts the array into a specified order (low to high) 

Removes and returns the last array item 

Adds an item at any index location 

Looks for an item and returns its index value 

Reverses the order of the array 

Telis you how many times a value is in the array 

Adds a list of items to an array 

Removes and returns the first array item 



You were to work out which two methods you needed to employ to 
allow you to sort the data in the order that you needed. 

The sort () and reverse () methods look the most useful. You 
need to use reverse () after you sort () the data, because the 
default ordering used by sort () is lowest-to-highest, the opposite 
of what you need. 
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data in files and arrays 


Sort the scores frow highest to lowest 

You now need to add the two method calls into your code that will sort the 
array. The lines need to go between the code that reads the data into the list 
and before the code that displays the first three elements: 



The avray stavb 3 ' ra ' , ' <l0 "' 

ovder. lis 'Wovted” 




Here is the existing program. Add in the missing code that sorts 
the data, highest-to-lowest. 


Pu-t the e*tv-a 
dodc V^cvc. v. 


scores = [] 

result_f = open ("results.txt") 
for line in result_f: 

(name, score) = line.split() 
scores.append(float(score)) 
result_f.close() 


print("The top scores were:") 
print (scores[0]) 
print (scores[1]) 
print (scores[2]) 


you are here ► 
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all sorted out 


^harpen your pencil 



Here is the existing program. You were to add in the missing code 
that sorts the data, highest-to-lowest. 


scores = [] 

result_f = open ("results.txt") 

for line in result_f: 

(name, score) = line.splitO 

scores.append(float(score)) 

result_f. close () At this poiht ih the Lodc, the array is 

in rnemoy-y but it's *ot in -the ovdevyou 


ruemovy 

^eed. Its unsovted- 


sdoves.sovtO 

/n These two method dalls will sovt 

s£o\res.\reve\rse data mto the ve<\uiv-ed ovdev-. 


print("The top scores were:") 
print (scores[0]) 

print (scores [1] ) ^ that the avvay is sovted, the -pivst 

print (scores [2] ) ilew»eivts dohtaifi the hijjh sdoves. 



A-P-tev the eall to sovtO and 
vevevseO, the avvay is sovted 
in the ovdev you need. i 



3 




It was very simple to sort an array of data using just two lines of code. But it turns out you can do even 
better than that if you use an option with the sort () method. Instead of using these two lines: 


scores.sort() 
scores.reverse() 

you could have used just one, which gives the same resuit: scores . sort (reverse = True) 
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data in files and arrays 



Update your program in IDLE and run it. Look what happens: 


hkjh_ 5 corfl_arr^y&_&ortod.(>y - heme/bar 


Die Ldit rarmat Bun Ephoris Wndorcs 


+■ _ 


JJeSp 


acores - [ j 

mi 1 f - f — rip^-ni ■£ ” rf.m 11 :ji . f.ict - H J 

line i eau 1 t_r: 

£nome, 3ct)L'c) - 1 i nc. pplit | i 
acorea.append£f Loa 
resuit fkclcacfl 



The addi-tiohal eode edures the 
l/ ' neSh, ^ s a<re m B»e ovdev- y ou «eed. 

i 




acore 3 . oort{) 

aixirrfi.rrvHr.iel ) 

ipi ini £ "TTitt-* I 1 1 [ i \ 

pnnt £acores | □ l ) 

Ti r i n h £Tiirorr:^ [ 1 [j Ji 
orlnt £ acores[ 2 \ ) 

I 


Looks wwth loe-tlev! 


The program works great! 



Die Ldrt &hdl Brebug Ephoris Windows 

Python J.1.1 (rJinvn^, /Lug 1H 2U0V f U/s03:I&) 
ffidin 4.1.1) rm limix? 

Type "copyriqnt" x "credJitB" or "Iioenae()“ tot raore rnlorsnation 
»> - ---—-—--— RE3TART 

_"h V ~m 

The top scorca ¥crc; 

9.12 
B . 65 
a . 

»> 


The scores are in descending order, and the program is really not much longer 
than when it found just one score. Using arrays allows us to solve a much 
harder problem with very little extra eode. And instead of using lots of 
complex logic and lots of variables, you have straightforward logic and only 
one variable: the scores array. 






















scores without names 


And the wmner is...? 

It’s time for the award ceremony. 

The prizes are lined up and the scores are on the scoreboard. 
There’sjust one problem. 

Nobody knows which surfer got which score. 
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Yoia taov» -the 

Sdoves, tat the 

swvtevs ve*«am a w>yst cr'j— 



Winners 








data in files and arrays 


You sowehow forgot the surfer wawes 

With your rush to catch some waves before the light is gone, you forgot 
about the other piece of data stored in the resuit s . txt file: the 
name of each surfer. 

Without the names, you can’t possibly know which score goes with which 
name, so the scoreboard is only half-complete. 

The trouble is, your array Stores one data item in each element, not 
two. Looks like you stili have your work cut out for you. There’11 be no 
catching waves until this issue is resolved. 


You 'Covcyrt “to 
pvodcss i\\t 



How do you think you 
can rememher the names 
and the scores lor each 
surfer in the contest? 

Once you Ve thoug[ht 
ahout this proflem, turn 
over to Chapter 5 and 
see if you can resolve 
this issue. 
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CHAPTER 4 


programming toolbox 



Your Programming Toolbox 

You've got Chapter 4 under your belt. 
Let's look back at what you've learned 
in this chapter: 


- ^ 




* ^ cS v,a 

a t o\\ett' ov ' ^ 

* avva 'f tV>at ta« 

**> ^ 

* - ■"*** 
or&tx 



Py-feKoh Tools 

* °^° - °P^ a -Pile U prodessi^ 

* closeO - tlose a -file 

* -Polr - i-teira-te over someihmg 

It” 5 ‘ rM ° ' ^ mh> —Jtiple 

* ° " **r/ '»d«* ofwafc»- 

* *->-ay.appe>.dO - add a» &» fe tt, «j 
array 

* f r fy- SoH/) " So ^ a » array, Ucst-h>- 

highest 

* av-vay.vevevseO - cha»ge the order ^ ^ 

array by reversihj i*t 
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5 JicisJies and datakases 



Arrays aren’t the only show in town when it comes to data. 

Programming languages come with other data-arranging goodies too, and our chosen tool, 
Python, is no exception. In this chapter, you’11 associate values with names using a data 
structure commonly called the hash (better known as dictionary to Python-folk). And when 
it comes to working with stored data, you’ll read data from an extemal database system 
as well as from regular text-based files. AII the world’s awash with data, so turn the page 
and start applying your ever-expanding programming skills to some cool data-processing 
tasks. 
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stili looking for a winner 


Who won the $urfing contest? 


In the previous chapter, you worked out the top three scores, 
but they’re not much use without the names of the surfers that 
achieved those scores. There will no be surfing for you until 
you Ve fmished the program. 



Winners 


Here’s the code so far: 


Chapter 5 


scores = [] 

result_f = openCresults.txt") 
for line in result_f: 

(name, score) = line.splitO 
scores.append(float(score)) 
result_f.close() 
scores.sort() 
scores.reverse() 
print("The top scores were:") 
print (scores[0]) 
print (scores[1]) 

)res [2]) 
















hashes and databases 




Rewrite your current program to use two arrays: one to keep 
track of the scores, the other to keep track of the surfer names. 


you are here ► 
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two arrays 



You were to rewrite your current program to use two arrays: one 
to keep track of the scores, the other to keep track of the surfer 
names. 


sdov-es □ 


fidmes — □ 


\resul't__'f — ofChOVcsults.-t^t 
-fo\r line i y\ vcsul*t -f : 


(r\Sn\C, sdove) =■ Ime.spIrtO 
sdo\res.appendCploa*t(sdo\re)) 
* nar*es.append(narne) 
v*esul*t_jp.doseO 
sdo\rcs.so\r*tO 


sdo\rcs.\rcvc\rscO 

Remembev fc> «*rt Ms sori() 

3V"V3^* . 

names.v-evevseO 


p\rin*t( u The highes*t s£o\res v /crc”) 
pv"irrWn3rnes[OJ + 1 v/i*th ^ + s*br(sdo\res[OJ)) 

prm*fc(na»*€sCI 3 + 1 v/rth 1 + st\r(sdo\rcsCI3)) 
pvirrKnaimesCZJ + 1 v/rth * + s-brfsdov-esCZJ)) 





Don't forget to download resuit s . 
txt from the Head First Programming 
website before continuing. 
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hashes and databases 



With the results.txt file saved to the same directory as your program, enter this 
code into IDLE and see what happens. Remember to save your program, then press 
F5 to run it. 


W tilgh_-score_2_ajray£..py ■ /horne/bairiYF^HeadFfr£tProg/ch.apt 

+ _ 

“1 

x 1 

Fjle frit rcrmFifr ftnn Optinn^ Windows 


jjrip | 


scDiree - [ J 

nriiiiri^ = 

r-a a u±t_l - opo n 4 " r esu Ita t " ) 

t r 1 S nr; r rr-nult: 5: 

[nsiiis r acore) — line,split() 
scorca. appcnd ( :£ loot i acore)) 
n ane s. ap&e nd [ name) 
result_f .cloac() 

ccorcc. oort 4 ji 
st;uL« a . l t: w tr l se ( | 


JJdJIIfSJ . UJ1 L ij |- 

n-njncc. rcverae [ ] 
print[ "Tfte higtiest aco 

[»r i ii L ([krima-f m \ ] + w 

print [ nar.aal 1J + ' wit 
rvr i nt 1 ( nftFiril 7 ] ! 1 wi. b 


These v-esults doni make sense/ 




Qpttons Wiridows 


Python 



Those results look a little strange. Zack is only a novice surfer but, according 
to the results from your program, Zack has the highest score. It looks like the 
association between the surfer names and their scores is somehow lost... and if 
you think about it, this is exactly what’s happening. 


The two arrays are independent of each other: one contains scores, the other 
names. When the data is in the file, the surfer name and the scores are associated 
with each other because they appear on the same line. However, once the split 
occurs and the data is in the arrays, the association is severed. Sorting one array 
has no effect on the ordering of the other. No wonder your results are a little off 
the wall. 


How do you fix this? 


you are here ► 
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need a new data structure 


Associate the m m with the score 


Using two arrays just won’t cut it. You need some other data structure to hold 
your data in such a way that the association between the surfers’ name and their 
score is maintained. 


Hev-es the 
avray o£ 

sov-ted ^ 
sCovcs** 




•**ahd heres 
the array 
s o\ricd 


^ames. 


Bui -the s&ores no lon^ev 
maith the »ames| 


VVViat Y ou r ' ee< ^ ,s 
somctWm^ 
looks like -tWis. 



You need a different data structure. But which one? 


%ckofer’s Orner 


siaoo^ 



Ala*y vows 
ot data 



£%actly two 

eolumir\S ot 

matthed data 



Da*ta S^v-udtuv-e A s-tandard **c*tliod o£ ov-^hizj^^ a 
dolledtioK <^f da*ta rterKS ‘m youv* dor^u-tev^s mcmory. 

You vc already r* ei ohe of “tKc dlassid daia s-brud-tuv-es: 
the array. 
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hashes and databases 






Match the data structure names on the left with their descriptions on 
the right. WeVe already done one for you. Which one do you think 
you’11 need to use for the surfer data? 


Array 


A variable that allows data to enter 
at one end of a collection and leave 
at the other end, supporting a first-in, 
first-out mechanism 


Llnked l!st 


A variable that contains data arranged 
as a matrix of multiple dimensions 
(but typically, only two) 


Quetie 


A variable that has exactly two 
columns and (potentially) many rows 
of data 


Hast 


A variable with multiple indexed slots 
for holding data 



A variable that creates a chain of data 
where one data item points to another 
data item, which itself points to 
another data item, and another, and 
so on and so forth 


Muki-dlniensfonsl array 


A variable that contains a collection 
of unique data items 


you are here ► 
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hash it out 



Amy 


You were asked to match the data structure names on the left with 
their descriptions on the right. You were also to identify which one you 
thought you might need to use for the surfer data. 


A variable that allows data to enter 
at one end of a collection and leave 
at the other end, supporting a first-in, 
first-out mechanism 


L!nked lfst 


rteves tVie 




Muhi-dinienslonal arrqy 


A variable that contains data arranged 
as a matrix of multiple dimensions 
(but typically, only two) 

A variable that has exactly two 
columns and (potentially) many rows 
of data 


A variable with multiple indexed slots 
for holding data 

A variable that creates a chain of data 
where one data item points to another 
data item, which itself points to 
another data item, and another, and 
so on and so forth 


A variable that contains a collection 
of unique data items 


Use a hash 


Knovm in tV,e PyJW 

as a u d‘»fct»oir\avy* 


You need to use a data structure that maintains the 
association between the surfer score and the surfer name, 
which is exactly what a hash gives you. There are lots of 
surfers with lots of scores, and you need to maintain the 
association between the two pieces of information. 


Let's take a look at how hashes work. 



Ciee]c BifS 


Hashes go by different names in 
different programming languages: 
mapping , dictionary , associative array, and 
key-value list , to name a few. In this book, 
we’ll stick to using the name hash. 


This duts down on -the 3n»oi*nt ot typing and saves ouv poov -Cinjevsf 
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hashes and databases 


Associate a key with a value using a hash 


Start with an empty hash: 




scores = {} 



The ke^/s $o 


scores 



The values go he\re. 


You add data to an existing hash by describing the association between the key 
and the value. Here’s how to associate a surfers’ name with their score: 



you are here ► 
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iterate hash data 


Iterate hash data with for 


Let’s add some additional rows of data to your hash: 


scores 


scores [9.12] 
scores [7.21] 



Pata m a hash is 
mamtamed i* a 

seemm^ly vandom order, 
Ut don i vorry aloout 
that for now- 


Once you have a hash created, you can use the trusty 
for loop to iterate over each of the rows: 




The "keysO" Uilt-in ««ethod retums an array of 
the keys of the hash. There ave no e*tra points +or 
oyuessing what the "valwesO" «ethod does. 


rak e each of the 

ktf y s i*» the hash 
tuiTh... 

for key in scores.keys () : 

print (scores [key] + ' had a score of ' + str(name_part)) 

...and display a dustom y/ 

- essa y ^ «tevving to a value assodiated with a kev us, 

m eatV> ^ "V** (K yo« did with avvay datT) 




HevVs v/hat would 
display cm s£\reen 
(assumi*^ ali *the 
data m 'Vcsults-t^ 
was available to the 
hash)- 



File Frirt F.heJI Flphug Gphnn^ Winirinw\ 

Joaech had a acore o£ fi.45 

L 

Juan had a scorc of 3™L2 
Z d.L.~lL hcLLl d 9LUIC of 7.21 
ftaron had a ocorc ot a . il 
A.initari htul n :ml:cie r uf ^.(1% 

Jotinny ftoh o acore ol 
l^I. rii,:e-:y lisiil r* nticirr ciT 7 . Fl 1 


Another hash method, called items (), returns each key-valuepair in turn, 
and can be used with the for loop, too: . 

--P* W)* .rfw (i(k 

Key-value paiv. 

for score, surfer in scores.items(): 

print (surfer + ' had a score of ' + str(score)) 


Whichever method you use to iterate over your hasffs data is up to you, 
because using items () or keys () produces the same output. 
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Code Magnets 


Rearrange the code magnets at the bottom of the page to complete 
the program shown below. Rather than using two arrays, this 
program Stores the results from the surfing contest in a hash: 


result_f = open ("results.txt") 
for line in result_f: 

(name, score) = line.splitO 


result_f.close() 


print("The top scores were:") 
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surfers with their scores 



Code Magnets Solution 

You were to rearrange the code magnets at the bottom of the page 
to complete the program shown below. Rather than using two 
arrays, this program Stores the results from the surfing contest in a 
hash: 



You to st*t wtfc 3 » ^ V ' asV ' 1 
as o ?? osed to a» W*?ty 


result_f = openCresults.txt ") 
for line in result_f: 

(name, score) = line.splitO 



> Aftev" sp|ittin<J ou*t the *3r*e and ‘the seo\re, use 

J the value of Vove" as the key of the hash and 


result_f.close() 


print("The top scores were:") 

Use a for looy-^i 
to yvofcess the * for 
eontcnts of 
the hash. 



the value of Vme as the value- 

/ou II -fihd out soon why the Vove" 

ahd W" is used (in this 

**e) as the key of the hash. 


print(’Surfer 1 + scores[each_score] + ’ scored 1 + each_score) | 


Pisplay eath vow fvom the hash, 
destvibin^ the asso^iation. 


tJiereiare no 

Dumb Quespons 



Can I append data to a hash just like I did with an array? 



Can I use anything as the key of a hash? 


Yes, and no. There’s no append () method for hashes 
like the one included with every array. To add a new row of 
data to an existing hash, use code similar to that used in the 
solution, above. Hashes do have their own set of methods, but 
appendO is not one of them. 


No, you can’t. The rules Python applies here can be complex 
(as they can be in other programming languages, too). The best 
advice we can give you is to stick with numbers and strings as 
keys.Trustus: this isn’t as restrictive as itfirstsounds and is, by 
far, the best/easiest strategy to follow. 
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Take the code from the previous exercise and use it to create a new file in 
IDLE. Gall your program scores_hash . py. When you’re ready, press 
F5 to run your program. 


tcoreac h. py - ih e m rry p> .'H oad F Irst P rogye ha p r 5/co <1 o.sc oresJha th. py 


£ile Trilit Format Run Ophnn*i jWinrlfvw^ 

ec ore b - {] 

rtfMtill. f = [j|ptrnf “ resimi L.ei. i ni 

i . line . n reault_±? 

(nflmftj. sirum J - linfs.nplih| J| 

Ecorea[score 1 ~ name 
rcou lt_f*cloac ( ) 

print ( n The top acore a wrc ; " J 

eacft_acore . rj acores. fceya ( f: 
print ( * 1 Gurfcr 1 - ocorcafcach scorc] + 


I 



otk««r ****** 



Great! Your program now uses a data structure that allows 
you to associate two related pieces of data together. 
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sort the surfers 


The data isw't sorted 


Your program now associates surfers and their scores, but 
it displays the data from the hash in some sort of random 
ordering. You need to somehow sort the data in the hash 
to find out who actually won the contest. 


Surf-A-Thon 


Python hashcs don't have a sortO wethod... 

In Python, hashes are optimized for speedy insertions and even 
speedier look-ups (searches). As a consequence, the good folks that 
created Python were less interested in providing a method to sort a 
hash, so they didn’t bother. 

\ 



...but there is a function called sortedO 


f “H. *' hd desi 9" implemeRtatio, 

dedisions lo-ts di&r e a p^ arnmi 
bhguages. P eop l e av e ditW- id So ai 
the pvo 9 va»».» 9 la« 9 ua 9 es they dveate. 


Obviously, there ’s a need to sort a hash so, again, the good folks that 
created Python decided to provide a really smart built-in function 
that has the ability to sort any data structure, and they called their 
function sorted () . Here’s how to use the sorted () function 
with your hash: 


Use -the so\rtedO -function -fco sort the 
keys o+ the ll s£o\res” hash. 

JV 

for each_score in sorted(scores.keys (), reverse 




Remembev-: the keys m youv hash ave 
•the sdoves, whidh ave nwmkevs, so we ask 
"sovtedO" to ovdev the» hi 9 hest-to- 
lowest usm 9 'Vevevse — Tvue ■ 




print('Surfer ' + scores[each_score] + ' scored ' + each_score) 


Thats one small change to one line at the bottom of your program. 
So, let’s go ahead and make that change. Now that you are 
sorting the keys of the hash (which represent the surfehs scores), it 
should be ciear why the scores were used as the key when adding 
data into the hash: you need to sort the scores, not the surfer names, 
so the scores need to be on the left side of the hash (because that’s 
what the built-in sorted () function works with). 



Make the change to your 
code to use sorted (). 
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With the one-line change applied, save your program and press F5 to run it again. 


fieorat hssh sorted. pv ■ . , Jiom&, , b^rry(j 1 , Head^lr&tProq, , cf>apier5/ec + - 


Eile Edrt fermat fium Gptions 


Ije-lp 


acores - [} 

rcault_f “ opcnp’ zcsulta. txt" ) 

ter line :n reault_f: 

(noiiiep acore) - Line■ oplit j ) 
ac ore a [ score ] = name 
rcaultf.clcacj \ 

pnnt("TM top acores werei " ) 

rjfirh ruznT*? finrfr^ ( ncznrftfi. k^y.^ ( ) t rriv^me: — Trnr- |- : 

print ( 1 Surfer 1 + scores | eaclr scoroj + r acored + eacft acore^ 


Python Shell 



Ti^c s£ov*es 3v*c assofi-idtad 

-bhe suv-Ws ^arncs and 
*t^cy av-e *oy/ sovbcd, *toof 



Eile Edit, EiheJI I}ebug Qptrcns ^indom 


>» 

Thh* L.ny MimrHM, wi-r:r n 
Surter Juan sooraa V ,12 
Surfer Johr.ny ocored Q.65 
Surter JoaepH acored 3.43 
Surfcr karon acortd Q.31 
Surler Aiaeen acored 3.03 
Eurfcr £t aeey aeorcd 7,-EI 
S 1 1 r fs-: t !Zrf< .n : 1 1 e mi t 7.71 

>» I 


Fantastic! You've identified the top 3 
suifers. Time to hit those waves, dude! 


Surf-A-Thon 
























more complex surfer data 


\ 


When data gets complex 


Hot on the heels of your success with the local surfing club, youVe 

just been contacted by the Regional Surfing Association (RSA) and 

they want you to write a new program for them\ RSAs offering a 

brand-new, state-of-the-art, epoxy resin surf board as payment... 

once the progranbs working to their satisfaction, of course. ^- f\\\s '»s *t oo y>od 3* 

1L, w dow- 

You ve been wantmg to try out an epoxy board tor ages. I he 
trouble is, they’re sooooo expensive and you’re a poor surfer. The 
waves will have to wait (yet again). But, the thoughts of surfing an 
epoxy board... now that’s worth waiting for. 


So what does £SA'$ data look like? 

Gurrently, RSAs data is stored in a text file using a proprietary 
data format. For each surfer, there’s six pieces of data recorded on 
each line in the file. 

Here’s what the data looks like: 



rteve are the ** pete» data- 


101;Johnny 'wave-boy' Jones;USA;8.32;Fish;21 
102;Juan Martino;Spain;9.01;Gun;36 
103;Joseph 'smitty' Smyth;USA;8.85;Cruiser;18 
104;Stacey 0'Neill;Ireiand;8.91;Malibu;22 
105;Aideen 'board babe' Wu;Japan;8.65;Fish;24 
106;Zack 'bonnie-lad' MacFadden;Scotland;7.82;Thruster;26 
107;Aaron Valentino;Italy;8.98;Gun;19 


Competition ID. 

Name . 

Country. 

Average score. 
Preferred board type. 
Age . 



KVt daia is stoved i* 
eaa line, with a ser»i tolon 
epa>ratih 9 eati ? \tte of data 


RSA has tried importing this data into their favorite spreadsheet 
program, but that didn’t really work for them. RSA wants a 
program that allows them to quickly find a surfers’ data based on 
their Competition ID, then display the surfers’ details like this: 


is nitelv labeled- 


ID: 

101 

Name: 

Johnny 

Country: 

USA 

Average: 

8.32 

Board type: 

Fish 

Age : 

21 


Bath data ite»« is displayed 
Oh its owh line, whith makes 
it really easy to vead Ulike 
the patked data f ile). 
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r 1 ^ ar P en y° ur _ 

Here's one surfer's data from the file, assigned to a variable called line: 


line = "101;Johnny 'wave-boy 1 Jones;USA;8.32;Fish;21" 

Grab your pencil and write some code to process this line and display it on screen like this: 


ID: 

101 

Name: 

Johnny 

Country: 

USA 

Average: 

8.32 

Board type: 

Fish 

Age: 

21 


'wave-boy' 


Jones 


Hints: If you pass a string parameter to the split () method, the data is cut where the string parameter 
occurs, as opposed to the cut occurring at a space character (which is split () 's default behavior). Also, 
consider using multiple-assignment on the left side of the assignment operator when assigning more than one 
name-value pairing to a hash. 
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Here's one surfer's data from the file, assigned to a variable called line: 


line = "101;Johnny 'wave-boy 1 Jones;USA;8.32;Fish;21" 

You were to grab your pencil and write some code to process this line and display it on screen like this: 


ID: 

101 

Name : 

Johnny 

Country: 

USA 

Average: 

8.32 

Board type: 

Fish 

Age : 

21 


Cui the Ime o-P data 
evevy time the splitO 
*»ethod sees a semitolon. 


Heve’s one yossible solwtion 



ine — w l Ol; Johnny 'v/ave—boy' JonesiUS/\;83ZjPishjZl w 


Cveate a» em ?U. 


u t> 


hash talled s 


Use mu Itiple- 

assi^ment io assi 

the sf Iit data ^vor* 
Ime to s . 


>s^n 




(sC'id’3, sC'name'3, srtowntvy’3, sDavevageh sr'boavd’3, sCa^e'1) — linesplitU”) 

. "J* . 


/ p<rint("|D : " + sC'id'3) 


Display six ni£ely_ 

•fov-maited messages 
oy \ seveen. 


pv-mtOWame: 

" + sCname'3) 

pv-mtPCouhtry: 

l> + sCdouhiv-y^J) 

pvint("Aveva^e-' 

” + sCaveva^J) 

p\r’mt( u Boavd type 

n + sCboard^) 

^jpv-ir\i( w /\ge: 

" + S C‘ase'3) 
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As always, you need to enter this code into IDLE before you run it. Then, save your 
program and take it for a spin by pressing F5. 




1 d l&p I ay_d at a. |>y ■ /h em e/b arry p/HeadF \ rst Prog/ch apters/t od <?/4 I &piay_d ai a. py - 


Hle frlit fermfit Rim Optioni; Windows 


1 i = "101; JuEiu]] y 'veive ->buy ' Juj Ltr a- ' U SA ; 0.3-2- T i ah -21“ 
a = {} 

( a [ 1 iii' ] ^ s[ ' n h itu-* ' ] a a [ 1 cumiLiy 1 ] F a [ ' dvtidqt? 1 ] e a[ 'Ixjaztl 1 ] T b[ ' d.yt: ' j J = IxjLtr. ap3.lL f "i M 


y i iJ!;L ( "ID: 
print ( "Hqjtuc : 
pxlnL ( "CullliLx. y : 
pri nt ( 11 Av c r ag c i 
px.l»L ( "Sudid Lyi^: 
print ( "Ages 


I 


ttey, tW.s data «s 
yv-etty easy to v-ead, 

‘ k? 


" + a[ “id" J) 

" + s| 1 nor.c 1 ] J 
“ f a{ " cjuuii Lry ’ | ^ 
11 + af 1 □.verage “ \) 

" + s| " bfJ n L |J 1 ] ) 

H + al"flgc , ]| 



Python Shell 


Die Ldlit EiheJI Uebug £3pticm5 ^in-dowa 


Pytfron J.l.l (rJll: MIBW, Aug 1« ^UUtf P 

{CtCT. 4.1.1] L-m 1 i nux? 

Type “copyriqlit" F "cr-sditH" or " Iicenset 3" tor more intonnation 
»> ---— HESTART - 

-■w > 

id 2 iai 

rjame: Jotinny 1 vave-boy* Jon-es 

Country s U &A 

Av err-d y t? : 6.32 

Doard t ypc : F i □ h 
Ahj k = ? 3 

>» | 


I m. I? Coi: d 


Your code works for one line of data. But RSA wants to be able to 
display the data for any surfer, not just wave-boy's. 
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Returw a data structure from a fuwctiow 

Processing one line of surfer data was pretty straightforward. But now you have 
to work with all the lines of data in the file. Your program has to make the data 
available quickly so that a request to display the details of a particular surfer can 
be performed as soon as possible. 

You already know enough to write a function that takes the surfer ID as a 
parameter, searches the file one line at a time for a matehing ID, and then returas 
the found data to the caller: 


suv-fc*. ID. 



There are really only two choices for how you retura data from this function. Pass 


back the surfeks data either: 

o 

As a string 

or 


o 

As a hash 


But which? Returning a string requires the calling code to further process the data to 
extract the information it needs, which (although possible) gets messy, because the calling 
code is then required to cut up the string using split () . This is something best left to 
the function, because it hides the complexity of manipulating the data from the calling code. 
Returning a hash allows the calling code to simply pick out the information it needs 
without too much fuss and without any further processing. 


Return a hash from the function to keep the calling code simple. 
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Code Magnets 


Rearrange the code magnets to complete the function required.The following 
functionality is implemented: 

1. Accept a single parameter (the surfer ID). 

2. Process the data file one line at a time, creating a hash from the line on each iteration. 

3. Compare the parameter against the ID read from the file. 

4. If the IDs match, return the hash to the caller. 

5. If no match is found, return an empty hash to the caller. 


def find_details(id2find): 


for each line in surfers f: 


surfers_f.close() 


surfers_f.close() 
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process the parameter 



Code Magnets Solution 

You were to rearrange the code magnets to complete the function required.The following 
functionality is implemented: 

1. Accept a single parameter (the surfer ID). 

2. Process the data file one line at a time, creating a hash from the line on each iteration. 

3. Compare the parameter against the ID read from the file. 

4. If the IDs match, return the hash to the caller. 

5. If no match is found, return an empty hash to the caller. 


def find_details(id2find): 


Ope* the file so that Y ou 
da* v-ead fi^e data- 


Use "£*•" to _ 
^°°P thirough ** 

eat . h the lines 
m the -Pile. 



for each_line in surfers_f: 

Make sure the hash stavts out er*pty. 



(s [ 1 id' ] , s['name'], s [' country ' ] , s [ ’ average ' ] , sfboard'], 

s['age' ]) = each_line.split(";") 


Chedk i-p -the IV 

su Pflied as a paVameteV 
is the same as the one 
**ead firom the file. 





surfers_f.close() 

-1 You have a matehf So, dose 

return (s) J : the file the* vetuvm the 

duvvent hash to the dallev-. 


Cut up the Ime (usmj splitO) and 
assigh thd data to the hash (using 

multiple—assi^hmeht)- 


surfers_f.close() 


return({}) I 

-1 




You protesed the entire 

t, bu , t NO match. 

Close the Pile a„ d retur» a » 
<">pty hash. 


r 


Lmi tlds! 




Download surf ing_data . csv from 
the Head First Progromming website before 
continuing. Be sure to put the file in the 
same directory/folder as your code. 
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Ba*e 

•*r 

Here's some tester code that weve cooked up especially 
for you. This code will let you test your function: 


Ask -the user ( o\r ihc 

suv&v ID -to -Pihd. lookup_id = int(input("Enter the id of the surfer: 


CaII w *f*md de-laiUO” 



surfer 


find_details(lookup_id) 


OY\ 


*the evrtev-ed suv-fcv IP- lf 


|£ data was -fourvd, 
display the n^ely 
'fovmatted mcssays 





surfer: 
print("ID: 
print("Name: 
print ("Country: 
print("Average: 
print("Board type: 
print("Age: 


+ surfer['id']) 

+ surfer['name']) 

+ surfer['country']) 
+ surfer['average']) 
+ surfer['board']) 

+ surfer['age']) 




Type this tester code, 
together with your 
function, into IDLE. Be 
sure to put the function 
near the top of you file, 
so that this tester code 
appears after it. 


Make sure the tester code and your function are entered into IDLE and saved 
to a file as a new program. Press F5 to test your function. 


C 

nip 


Python she 


Bnier an e*isti*g swv-fev 
IP and the p*-o<yram 
displavs -the detaiU 


Eirteir a hohexisier,-/- 

|p a »d th e 
program displays 

«o-thing (as thev-e's 
«othing io display). 


r .hpji Dphurj nphnn«i 



1 'ytfjon 3 . 1*1 Aug ns uyaUJs*:*) 

jffSCC itn 1 i nux? 

Type "copyngtit" r "credita" or "licenae[ j" tor rnore mlormation. 
>» m mi mmmwwmmm mummmmmm mmmmmmmmmm m RTI.SYART 
>» 

TCntirir 1 thr iri of t.hr- inrffr: lf \A 
ID a IU " 

Hfl-mr : 5\ E-.a c :«y ft * Nr ili 

Country s Ireland 

Average* D . $1 

Board. type; Kalilxu 
Age : £2 


Great work! Your function is working well. Wonder how the RSA 
folks feel about it? 
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surfing success 


H ere'$ your wew board! 

The RSA folks are delighted with your work. 



Your program really hits the mark. The RSA folks can display 
the data from their tightly packed data file in a way that makes 
it easy for them to read and work with. It’s fast, too. 

Your use of a hash within the function was an inspired choice. 
The calling code only needs to be aware that a hash is being 
returned from the function to work with it effectively. And, as 
youVe seen, returning a data structure (like a hash) is as easy 
as returning any other variable from a function. 



i 

—- ttevVs youv* bvand 
boav-d.. stavt 
it dude! 


Word of your programming skills is spreading 
far and wide. 


168 Chapter 5 








hashes and databases 


Meanwhile, down at the studio... 




Head First TVN is an up-and-coming sports 
network specializing in everything and anything 
to do with water. They are covering the National 
Surfing Championship and want their TV 
presenters to be able to use your program to 
access each surfer’s details in much the same 
way that RSA did. There’s just one small kink in 
their pians: TVN has all their data in a database 
system, not in a file. 




Tke TVN CEO 







Which part of your program is most likely to change if you have to get the 
surfer data from a database, as opposed to a file? 
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all in the details 


The code remains the sanie; it'$ 
the function that changes 

Your program expects the f ind_details () function 
to return a hash representing the surfer’s details. Rather 
than the function searching the file for the data, it needs 
to search the TVN database, convert what the database 
provides to a hash, and then return the hash to the 
calling code. 

All you need to know is which database System TVN 
is using and how to access it from your function. 

Let’s base your code on TVN’s code. 


. 

hffj* 




I asked our technical 
people and they told me we 
use SQLite3... whatever 
that is. They also gave me 
some code for you to amend. 
they told me youd know 
what to do with it, which is 
just as well because it's all 
gobbledygook to me! 



m 


Reapy BaKe 

■v 

Here's the TVN code: 


pov* b the standav-d -n!T 

* , „ . - import sqlite3 

liU-avy 

and £onne£t to “the 
data m the database 
-file (Y/hidh you £3n 
doY/nload tv-om this 
book^s Y/ebsite)- 


db = sqlite3.connect("surfersDB.sdb") 


Prodess eadh ot 
the voy/s... 

...lookin^ tov a 
suvtev Y/ho bas an 

|P ot IO*. 


t 


db.row_factory = sqlite3.Row 
cursor = db.cursor() 

cursor.exeeute("select * from surfers") 
rows = cursor.fetchall() 
for row in rows: 

if row['id'] == 104: 

print("ID is " + str(row['id'])) 
print("Name is " + row['name']) 
print("Board-type is " + row['board']) 
cursor.close() 


^v*ab all the sumtev* 
data t\rom the 
database, assi^nin^ 
the data to a vaHable 
£alled Voy/s w . 


P\rint out 
some ot the 
data (it Y/e 
J have a m at^h). 


Tidy up attev youvselt (ataays a good idea)- 


t F-pnJ.-r 


H&ad First 

SQL 


itTdwa. •-*«« th. <ffewi »a f»»- 

rtto—e».) "»«■* F»* MH- 1 tu “ '“ ko " ant 
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Rewrite your function to retrieve the data it needs from the TVN 
database. Use the ready bake code as provided by TVN's technical 
people as a basis for your code. Bear in mind that your program 
expects the data in the hash returned from the 
f ind_details () function to be a collection of strings. 
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grab the data 

r^t ar P e 


n 



You were to rewrite your function to retrieve the data it needs 
from the TVN database. You were to use the ready bake code as 
provided by TVN's technical people. You were to bear in mind 
that your program expects the data in the hash returned from the 
f ind_details () function to be a collection of strings. 




.... dc£. £\nd . . dctaiUCid^.irxl); 


ali the 
data -(Vom the 


su\r+e\r 



When a maUh is *fou*d.« — > rpwfid'3 . ~ . 

. A.rr.il . 

sfid.3 . rr.. ?tr.(v:W.C!i.d3.) . 


...build the hash ov\t .. tt. .V:py/C^m^3 

key-value paiv- at a 

tirwe* v . sC&Qw>t*y.3. ?r. xmCCtQwhry.l 


... 3. .=r. st?r(y-pyjra y erage/3 ) . 

srbpar.d'3. ... xw.Cb.Q&cd'.} . 

sCtytl 7 1 st\rfy-oy/C 1 ®!^ 


ReU» ihe hash. ^«^oseO 

to the dalliha__ x / ^ 

A j / , p ~ retu\rr\Cs/ 

toAt (as be+orev.. . 

duv-sordloseO 


\retu\rh({}) 


172 Chapter 5 














































hashes and databases 



'esr DriI/q 


Ghange your program in IDLE to use the new ver sion of the function (which now talks 
to TVN’s database). Save your program under a new name and press F5 to run it. 



tqlltoJ-findIt.py ■ yhomo/barryp.HMd FIr-stProg/cha p + - 


File Frirt Format Run Ofihont JWuiri^ 

unpori oqlitcd 

li r a d_dctQ il o [ i dZ t ind ) i 

e31i = rwj'T i l.rf.l-i.fc]nntfc:t. jj M :-viir Fr l ) 

dO - row_ta.ctory - a q 1 1 1 c i. llow 

s:ltT Miir e* rHiirf J 

cursor. cxccutc i " □ e lcc t ’£ ros au e I cr»" |i 

= [:iii»[ir . fVLirhrs Y1 i \ 

row in ro-ws: E 

FiIp £rlit r ph,pJ! F^bug Gpthnn^ WinrlnwiR 



r 


L<aai thls! 




Download surfersDB . sdb from the 
Head First Progromming website before 
running this test drive. 


f i[w[ " ii( u ] 

* ” U 
Lli l 

b [ 1 n ase 1 J 
m [ 1 nniir.F r 
b[ 1 averaq 
n [ ' htrm rd 1 
B[ ‘aqe’ ] 
mnor. r.l 

r s t u r n | s) 

rzn r.tor _ cz 1 n?ir ( t J 
retura( H ] 

loolMip_i(l - int^inpuc 

surfer - £lnd_d©tailB 

.f len( surfer ) > 0~ 
print ( "ID : 
print ( "Nase: 
print ( "Ccmntry: 
print ( "Jkveraqe: 
print ( "Doard typc 
print ( "Aqe* 


Python Shell 



1'ytnon i „1*1 [rJUrHlUU, Aug l-B U/iDJM!*} 

|GCC it. 3 * 3 ] u i l 1 xxl'ja 2 

Typo "Copyright",, "credito" or "Iiccnuc{)" tor itorc ihtonnaticn. 
>» ============================= n^sTftnr 

>» 

"Rnl.Mi I ii 3 nf t.Tm HiirfKr: 103 
IDE 102 

N>i iiir-: : .tunn Hrt r |_ i csn 

Countryi s>pain 

A U hf T .-JiJ H I ij.fr 1 

Daard type : LUin 
Ahj k- 1 fi 

»> ----------HLKTAKT 

»> 

Knter tne id ot the Buriers 2VU 

»> —--—------ ftriSTRHT 

»> 

T.n 1-i^r -i d nf t.h f nmr ffiri 1 tHV 

IUI lOb 

Mriirii^ x ?.n r: V * hfvrm i fft- 1 n.d f M nr. T n rfri ftea 

Uountry: Scotiand 

Avrrn rfft z 7 . fl 2 

Board type: Ttiruat er 
Age i 2 G 


Now, as well as working with data in files, you can extract data from a database 
system. Your program fully integrates with TVN’s SQLite3 technology. 

Send off that code to TVN, and sit back and wait for the 
money to roll in... 


\ 

dispUys similae 
outfut bo bc-forc.- oy\\ y, *bbis 
-time, -the da-ta is tomiinft -fv-om 
a database, MOT a -file: 
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data in the spotlight 


TVN'$ data is <m the money! 


With the surfing data now displayed directly from the TVN 
database, the sports writers no longer need to worry about all 
those tattered and torn competition entry forms. The data 
is right there on screen when they need it. They couldn’t be 
happier. Your program has made their day. 




The TVN spor-fcs 

writeirs k*ow how io 

delebi raie. 
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hashes and databases 



Your Prograwwiwg Toolbox 

You've got Chapter 5 under your belt. 
Let's look back at what you've learned 
in this chapter: 


*»+ ' * — 

a 

# y-eW»"^ 3 

a ^wAoyf. 

* datare ^ 

*• *£% S. -•^ tW 

o^arvbt>e s ^ 
via^ 



Python Tools 


* 0 - an emp-ty hash 

* «TWJ = «off W - se ts a* va|uc 

r$f^* WmtheVtehfeto ' 
LtXT’ ide 3 list rf kt > ! u tte 

LtiSv’ w •*^-* 

!+'r ?*?.' iFliUKe ^‘“^«d 

w.tt„ tt e !•,«■ vaviable * twy ^ 

a cornmd 

* Ttf 7 S ^ ** «a «rt 

»>ost data sWtures 
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6 modular prpgrammtng 



* Keeping things straight 



The code thatyou write will make its way into many programs. 

And, although sharing is good, you need to be careful. One programmer might take your 
code and use it in an unexpected way, while another might change it without even letting 
you know. You might want to use one function in all your programs and, over time, that 
function’s code might change to suit your needs. Smart programmers take advantage of 
modular programming techniques to keep their workload manageable. Let’s find out how 
in the pages that follow... 


this is a new chapter 177 



technology upgrade 


Head First Health Club is upgrading 
some systems 


Head First Health Club has a new GEO, and he loves new 
technology. He was shocked when he saw how old the sales 
systems were. 



Some of our technology 
is really ancient. I want to 
start by replacing the cash 
registers with new POS 
systems. Can you help? 







The old £ash irejjisters 
really *eed to be repla^ed. 

A/ 



Old a*d 


The «ew syslem ' M '" ' rwr ' 
a PC a«d attept 

trcdil tardi yay^ett-b- 



T 1 

The hew hotness 


A point-of-sale (POS) System is just a computer program that 

ace all 

of the cash registers immediately. He wants to begin with a trial 
system in the coffee bar. 


works like a cash register. The boss doesn’t want to repi 


Let's see what the coffee bar POS needs to do. 


Ii would be hiee i-P the systems 
you pvodude u/ere modular i» 
desi0m You'll gei io ibat 
AFTBR you’ve speni son>e ii«, e 
whdev-s-bhdimg what's v-equiv-ed. 
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modular programming 


The prograw needs to create a 
trawsactioH file. 

The POS program will record credit card sales in a file called 
transactions . txt. At the end of each day, this file is sent 
to the bank and any money is transferred from the credit card 
account into the health club’s bank account. 

The bank has sent an example version of the file for you to see 
what sort of data you will need to generate: 


The -Pirsi I& dhavattevs ave ^ ^havae-tevs destvip-tions -follov/. 

the dvedit £avd numbev. ^ pviee. ^ 



The file contains formatted data. There’s a line of text (or 
record ) for each item sold. The first 16 characters of the line 
are the credit card number, followed by 7 characters that 
represent the sale price, excluding the decimal point (so SI.75 
is written as 0000175). The rest of the record is a description 
of the item being sold. 



VMM 


How would you create a string of characters in the correct format for the 
record? Which parts of the record will be the hardest to create? 
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string formats 


Use strings to format strings 


Many programs need to create strings with particular pieces of data 
at particular places, so most computer languages try to make life 
easier for you by letting you use string formats. 

The best way to understand string formats is with an example. Open 

up the Python Shell and type in this: 7 -^ *pirs£ valuc w'll 

be ihscrtcd as a 
dbaradier number. 


»> print ("There are %5d %s available" % (17, 


The setoind value Wtll be 
mserted as a sbri»<y 

"donuts")) 


There are 


7 


17 donuts available 


Tbe number bas e%*lra spades 
added ai *tbc -front, *to make 
sure it takes up tbe re<\uired 5 
dbaradters. 

When Python sees a string followed by a percentage (%) Symbol, 
it knows that it needs to consider the string as a string format. 
The values that follow the % operator are going to be inserted into 
the formatted string in the order specified, one value at a time. 
Wherever Python finds a % inside the string, it knows to insert a 
value. 

A number -format 

spedi-pidation —3> %5d 



The strin^toriwaCth^ 

operator 



O 


When Python sees this, it will insert the value 17 as a 5-character 
whole number—that’s because the “d” type specifier telis Python 
to print the number as a decimal. Because 17 is not 5-characters 
long, Python will left-pad it with 3 extra spaces at the front to make 
it the correct length. 


A string format^ 
spe£i-fi£dt*or 


%S 


This Symbol telis Python to insert the value “donuts” as a string. 
As you are not specifying a length here, the string is inserted as is. 



These are just two examples of how to format 
values in a string. There are lots more. 
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modular programming 





Match each format string to what it does. WeVe already done one for you. 


"%s %e" % ("Value is”, 16.0 ** 0.5) 



"%s is $%4.2f" % ("Popsicle ", 1.754) 

"%s %f" % ("Value is", 16.0 ** 0.5) 

"%07d" % (11232/3) 


Display a string followed by 4.000000. 


Display a string followed by 4.000000e+00. 


Display the value, padded with Os. 

Display the resuit of the calculation, padded 
with spaces. 

Pad the string out to 20 characters, then display a 
newline character. 

Display the number as a hexidecimal (base 16). 

As well as a string, also display a floating point 
number to 2 decimal places. 



Be <taire-Pul with the 
deiimal point in the 



Look back at the records you need to create for the transaction 
file. Each line will need to end with a newline character. If you 
have the credit card number, price, and description in variables 
called credit_card, price, and description, write 
down what you would use for the format string: 
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format string 


l-f you havc jus-t 
one value to -PoV^at, 
you don^t need to 
suvvound it v/itb 
paventheses. 





You were to match each format string to what it does. 



"%s %e" % ("Value is”, 16.0 ** 0.5) 


"%7d" % 


(11232/3) 




” a -~” % 127 


^ v i 


\n means take a NfcWLINfc- 

$ 

”%20s\n" % "Banana swirl" 

This means "use ^ dharatters." 

iy 

"%s is $%4.2f" % ("Popsicle", 1.754) 

This means "show 2- numbers 
a-fter the detimal point- 


I! Q. 


%s %f” % ("Value is”, 16.0 ** 0.5) 

\/alues ean be tbe 
vesult o( a dal^ulation. 

”%07d” % (11232/3) 

Following the % with a 0 
r^cahs 'pad with zevoes/* 


Display a string followed by 4.000000. 


Display a string followed by 4.000000e+00. 


Display the value, padded with Os. 


Display the resuit of the calculation, padded 

with spaces. ^_ y detault, Python Vili pad 

us\n$ scates. 

Pad the string out to 20 characters, then display a 
newline character. 


Display the number as a hexidecimal (base 16 

^_ 


As well as a string, also display a floating point 
number to 2 decimal places. c * a de<hr»al numbevs 

ave used -for tbmjjs 
like dolovs oy\ the Web. 



Pon t wovvy i-f youv answev doesn t 
look E)<ACTLV like this. Tvy out youv 
answev in the Python Shell b> dbedk 
that it wovks. N \^ 

w %l ts%07d%l ts\n 


You were to look back at the records you need to create for the 
transaction file and write down what you would use for the 
format string: 



Multifly»^ by 1 00 and 

displayin$ it as a >whole number 
etrefctWely removes the 
detimal point trom the prite- 


(dvediijtard, pv-ide^lOO, desdviption) 


Cvedit davd numbevs should always 
be e*attly dhavadtevs. 






You need a newline £hava£tev 
at the end o£ eadh line. 
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modular programming 



Code Magnets 


Now that you know how to format the records in the 
transactions . txt file, it is time to write the rest of the coffee 
bar POS program. Complete the code below by arranging the code 
magnets in the correct place: 


def save__transaction (price, credit_card, descriptiori) : 
file = open ( "transactions.txt", "a") 


The "a” means you ave always 
301*9 -to APP6NP vetovds 
•fco "the end of "the f ile- 


file .write ("%s%07d%s\n M % (credit_card, price * 100, descriptiori) ) 
file.close () 


This is -the fovma-fc s-tving you just £veaied- 


items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 
prices = [1.50, 2.0, 1.80, 1.20] 


running = True 


while running: 
option = 1 
for choice 



in items: 


The loop v/ill keep while 

«the 'Vuwnimj vav"»able has “the 
value Tvue. To e*d *the \oo^> set 
U vuy\ir\nr\0y False* 


option = option + 1 
print (str (option) + ". Quit") 


if choice == option: 


else: 


save_transaction(prices[choice - 1], credit_card. 
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new pos program 



Code Magnets Solution 

Now that we know how to format the records in the 
transactions . txt file, it is time to write the rest of the coffee 
bar POS program. You were to complete the code below by arranging 
the code magnets: 


def save_transaction (price, credit_card, descriptiori) : 
file = open("transactions.txt", "a") 

file.write( "%s%07d%s\n" % (credit_card, price * 100, description)) 

file.close() 

items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 

prices = [1.50, 2.0, 1.80, 1 . 20 ] <^This is the «.atdhing avray ot «,enu prices 

running = True 


e" 


TWis is the av-vay <£ 


while running: 
option = 1 


tT”" ^* IS to< ^ e displays -the 
pvogiran,'s menu. 



print (str(option) + Quit") 



..The wsev a wtm , 
^ option nw»>bev to ">ake a sale- 


if choice == option: 


This will be True i-f the usev seledts the LAST 
running = False tion on the menu, whidh is "$uit- W 


else: 


credit_card = input("Credit card number: ") 


save_transaction(prices[choice - 1], credit_card. 
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modular programming 



The machine has been set up in the coffee bar just in time for the 
boss to come in for his morning latte, so let’s run the code and see 
what he thinks. Run the program in IDLE: 


\m |. n fncruL 1 ran .. 


The sales ave ve£ovded in 
*the 't-V“ahsa^'tiohs."tx"t -Pile- 



Pfth^n 5 -hvlE 


?:n. g-chr 'iihpj) Qptkmi tfiurir:**. 

Python J.C.,1 l r JC L O 'J JTi 0 . Lci? 17 341*9, Lis 15:17] 
[CCC 4,3,2] or. llM*i 

ry|M “c-iaji-jfTtqftt", ^^ruid LI si“ ht - ||.E:nr 

>■> * Mi B UBHIaiiH^I(HiiiildaiMaiiiiHaiil«Altila RESTAftT 

Dhttff 
i. latiz; 

,1 r r |. I.TFLH 
4 , HUTTIZI 
>> Qu l\ 

l^hw»HA sin r-jtt Ljiti: S 

Credit «rrt nntars 
i . rxHii «r 

2 1 L-j\T7C 

1, FIITEfl 
| T wiriTn; 

1. Duit 

ritt h inr ii 'a i?]kI L-;: n : 1 

Cnflit «erd tiuUrelN h J*JT4*2 J9Y-MU JJ 
I , KHfUT 
□ ■ Lb.ttc 
riLTEU 
4 , HlfTFTH 
ir quit 

Cfieoae aa apri-ns s ? 

>>:■ 


The program displays a list of items for sale and when you choose 
one and provide a credit card number, it adds the sale into a file 
called transactions . txt. This is the same file that the POS 
system in the gym uses. 



The boss agrees to try out the system in the coffee bar, and he even 
agrees to extend the trial and let your friend create another POS 
for the gym, based on your code. 

Things are going really well. If they continue like 
this, you will win the contract to replace all of the 
Systems at the health club! 


The newlittC £hav3£*tev. 
makes suve *the sales ave 
vetovded o* sepavate Imes. 
(You ea* *t see ihe* m *the 
, but they ave tbeve.) 
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real-world format strings 



The Format 


This week’s interview: 

Why do appearances matter? 



Head First: Format String, it’s a pleasure to meet 
you. 

Format String: The pleasure is all mine. 

Head First: You’re not just used in Python, are 
you? 

Format String: Oh no. I’m really used in lots of 
programming languages, like G, G#, and Java. You 
see me crop up all over the place. 

Head First: Why is that? 

Format String: Well, I don’t like to blow my own 
bugle, but I am kind of useful. Everywhere you need 
to generate formatted text, I can make life a lot easier 
for you. 

Head First: Can you give us some examples? 

Format String: Oh sure. If you need to send data 
to another system, you’11 probably need me. If you 
want to display an error message in a specific format, 
I’m good at that, too. 

Head First: I hate to say this, it seems so rude, but 
isn’t it possible to do everything you do with just 
normal string operations? 

Format String: Please, I don’t take offence. Yes, 
you can do pretty much everything I do by writing 


code and creating strings manually. But I don’t think 
that’s a great idea. 

Head First: Why ’s that? 

Format String: Two reasons: first, you might have 
to create a lot of code, and second, Fm a little more 
dynamic. 

Head First: What do you mean? 

Format String: Well, I’m just data. Lots of times, 
programmers prefer to use data instead of chunks 
of code, because it means they can store me away 
as configuration. So I get used a lot for things like 
internationalization. 

Head First: Internationalization? 

Format String: Yeah, say someone wants to display 
a message that someone has the top score. They 
could write the message in a file like “%d is the top 
score!”. If they write a French version of the game, 
they just have to amend me to “%d est les points 
superieurs!” 

Head First: No code change necessary. 

Format String: Exactly. 

Head First: String Format, thanks for your time. 


tfiereiare no 

Dumb Questions 


P Those format strings look a little 
weird. How do I find out more about 
them? 


A good reference book (we present 
ourfavorite in the appendix) will contain all 
you need to know and there's also lots of 
material on-line in the official Python docs. 
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Oj Are there special rules for what's 
acceptable as a credit card number? 


p Why does the code generate the 
menu in such a complex way? 


Yes, there are. But let's not get 
bogged down in those type of details at this 
stage. Concentrate on the 
save_transaction () function 
and how the code interacts with it. 


Ifyou study the menu generation 
code, you will see thatwhen you add more 
items and prices, the restof the code 
doesn't need to change to supportthe new 
items.The menu is generated automatically. 




modular programming 


A late night ewail ruins your day 

A few days after the demo, you get a late night email from the 
friend who wrote the second program (based on your code): 


I hT" 




nf 


«■code- it*s with your POS program runn.ng m the coffee barjne 

sort thingsout. 


tu 


See you in the morning! 


Something really strange has happened. Even though your code used 
to work, it has suddenly started to go wrong. Meanwhile, your friend^ 
program, which is really just a modified copy of your program, is 
working perfectly. 

Looks like you better get to the Health club bright and 
early tomorrow morning and see what's happened. 
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pricey donut 


$50,000... for a dowut?! 

When you arrive at the health club you find out exactly what’s 
happened. The entire day 5 s sales have been rejected by the 
bank for two reasons: 



o 


The credit card numbers are all fake/invalid. 

The bank was really worried about this one because they think someone 
must have hacked into the System to generate the messed-up credit card 
numbers. 



The prices are ridiculous. 

One of the recorded sales was for a donut that cost over $50,000! 


And what makes it worse, this 
was the f irst time we sent the 
transaction file to our new bank! We 
only switched over the day before 
yesterday so that I could secure a 
loan for the new weight room! 


This looks like a really serious 
problem. Let's take a look at 
the file that the bank rejected. 
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modular programming 


Owly the sales frow your program 
were rejected 

The transactions . txt file that was sent to the bank contains all 
of the day’s sales from both your POS program in the coffee bar and 
yourfriend’s POS program in the gym. This is a section of the file: 




This . rctord is -fv-or» the 
£o++ee bair and was 

RBJBCTBt) by the bank. 
- 


50791428746281510000150 


00035005002454912715921 


DONUT 


WORKOUT 


TW ' SW ~ d vias 

tc$r rep W ^ 


As expected, each record (from each of the POS programs) has been 
appended to the transactions file. That bit appears to be working fine. 


But, something is not quite right here... 





Study the two records carefully. Is there a difference between them that 
might explain why one was accepted and the other was rejected? Think 
about recent events. What do you think has caused this problem? 
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change in format 


The new bank uses a new format 

Your friend telis you that just after taking a copy of your code, the word 
came down that the health club was switching banks. Without tellin gyou, 
your friend found out the new bank format and updated his code in the gym 
program. 

That means that the POS program in the gym is generating records in the 
new bank format. 

The new bank format is: 


Price / Credit Card / Descriptiori 


Tkis is *thc pvidc- fZZ.OO. 

0003500 


TW»S »s Arcdvt 
£av-d nurobev- 

_ 

5002454912715921 


. The ' ,s a 

des£v-'»pt»oy\ ok *the sale 


WORKOUT 


OK, thafs another 
workout sold, so I'll write 
Price.... then Credit Card.. 
then Description... 


O 


o 


The bank accepted the transactions from the gym because 
they were in the correct format. 


But what about the coffee bar program? 
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modular programming 


Your coffee bar program stili uses 
the old format 


Your program in the coffee bar was never updated after the health club 
switched banks. It’s stili doing what it always did: it’s stili creating files 

in the old format. 

That old format wrote out the price and the credit card the other way 
round , which meant when your program wrote out a record like this: 


So that's a donut. 
Better wri+e Credit 
Card... then Price... 
then Description. 


The £redi*t eav-d hur»bev~ 


P ViU =■ \\SO 



Pesdr'»\>W 


The new bank read the record like this: 


The prite- jsOfflAll 



5079142 


«f ‘f’ "iZ 

■the ba*k thowo,ht \i ^ ' Vake ' 


8746281510000150 


_ 

DONUT 


O 

O 



Bui ai leas-t -the 
deserip-tioh^s 0 ^. 


This is suspicious... 
$50,000 for a donut.... 
Does not compute... Fake 
credit card informationi 
Security! Securityl! 


O O 


So it’s not that somebody broke into your program and changed it. 
No, it’s the exact opposite. Your code never picked up the change that 
was made to the gym program in order to support the new format. 




VMM 


What should you do to fix it? What shou!dn’t you do? 
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don't copy, share 


PowT just update your copy 

The code in the gym program is a copy of your code in the coffee bar. 
And copying code is a bad thing. Once you have two separate copies 
of a piece of code, then changes need to be applied in two places. 
So how do we avoid copying code? 

Smart programwers write modular code 

The secret is to break your programs into smaller pieces of code 
called modules. What’s a module? It’s just a file containing code the 
computer can run. Every Python program you Ve written so far has 
been a single module. 

But most programs youdl write will probably be split across many, 
many modules. And writing modular code is important because 
modules can be shared between programs. 



transactions.py 


If you separate out the code that saves the transactions to a file and 
store it in a new module called transactions . py, that module 
can be shared by both programs. If you then ever need to change 
the code in transactions.py, both programs will pick up the 
changes automatically. 
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modular programming 


$o how do you create a module...? 

Remember: a module is just a file containing some Python code. So, take the 
code that you want to share out of the gym_pos . py file: 



Then save this code in a file called transact ions . py. You have just 
created a new module. 


...and how do you use it? 

Once you Ve created the module, you then need to teli the programs to use it. 
When you were using library code you needed to import it. You do the same 
thing with your own modules. So, instead of using library code from the 
Standard Python Library, youVe really just using library code that you Ve 
written yourself. You can add this line to the top of each of your programs: 


This line needs to be added 

V a *y Pthat uses the 
tracsactioKS.py" module. 


This means 'Vun the to 
the «amedi modwle- 

from transactions import * 


k=-T\\\s mea*s w *tv-ca*t evev-ythi*;) mside 

«the module as i-f i*t is dode withm 

» 

youv pvo^vam. 


With this line, you are telling Python that you want to run the code in the 
transactions .py file and this allows you to access whatever code the 
module contains as if it isjustpart of your program. 

It's time to fix the programs. 
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tale of two programs 



TWis is -the «°de 

K doWee_?<*?/ fvooyva*"- 
' 1 


These are the two POS programs. Here is the code to the one 
used in the coffee bar (that you wrote): 


def save_transaction(price, credit_card, description): 
file = open("transactions.txt", "a") 

file.write(" %16s%07d%16s\n" % (credit_card, price * 100, description)) 
file.close () 

items - ["DONUT", "LATTE", "FILTER", "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running: 
option = 1 

for choice in items: 

print (str (option) + " . 11 + choice) 
option = option + 1 
print (str (option) + 11 . Quit") 
choice = int (input ("Choose an option: ")) 
if choice == option: 

running = False 
else: 

credit_card = input("Credit card number: ") 

save_transaction(prices[choice - 1], credit_card, items[choice - 1]) 
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The other program is very similar (which your friend created for use in the gym): 


def save_transaction(price, credit_card, 
file = open ("transactions.txt", "a") 
file.write("%07d%l6s%l6s\n" % (price 
file.close () 


( This is the eode io the 
p/ Sy^-Pos.py" pv-ogvar». 

description): 


* 100, credit_card, description)) 


items = ["WORKOUT”, "WEIGHTS", "BIKES"] 
prices = [35.0, 10.0, 8.0] 
running = True 

while running: 
option = 1 

for choice in items: 

print (str (option) + 11 . 11 + choice) 

option = option + 1 
print (str (option) + 11 . Quit”) 
choice = int(input ("Choose an option: ")) 
if choice == option: 

running = False 
else : 

credit_card = input("Credit card number: ") 

save_transaction(prices[choice - 1], credit_card, items[choice - 1]) 

Using a pencil, modify the two programs so that they use the transact ions . py 
module. Then write what you think should go into the transact ions . py module here: 
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transactions module 



These are the two POS programs. Here is the code to the one 
used in the coffee bar (that you wrote): 


d g f a a v e_u ransac t io n {p - r - i cc, u iudi L_C u r ei, dei strri p L i u n) ; — 

( " i nn^pnnn.q.ry^ —” aJ! ) 

rwi i le ( " % JS^o 0 7d-o 16s \if" % f^ed i t _c a rd, piiue * 10 0, description) ) 
— I ~ Tfe. u 1 - feH S e (- )- 
-fvom *brar\sad*tior\S impoirt ^ 

items - [ "DONUT", "LATTE, "FILTER", "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 


while running: 
option = 1 

for choice in items: 

print (str(option) + ". " + choice) 
option = option + 1 
print (str (option) + 11 . Quit”) 
choice = int (input ("Choose an option: ")) 
if choice == option: 

running = False 
else: 

credit_card = input("Credit card number: ") 

save_transaction(prices[choice - 1], credit_card, items[choice - 1]) 
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The other program is very similar (which your friend created for use in the gym): 

a 11 s & ci edit _card, Ctesci iption) : 

fi re - ujjen ( Tt transacLiuns . LxL", ” cr ! "j 

ile .wiiLe (" %07d%16s%lGs\ii n —%— (pr ice * iuu, crea i t_c did,— decor ipt - TOn ) ) 
f i jrcv.el^e () 
trom trar*sactior*s import ^ 

items = [ "WORKOUT , "WEIGHTS" f "BIKES"] 
prices = [35. 0, 10.0, 8.0] 
running = True 

while running: 
option = 1 

for choice in items: 

print (str (option) + 11 . 11 + choice) 

option = option + 1 
print(str(option) + ". Quit”) 
choice = int(input("Choose an option: ")) 
if choice == option: 

running = False 
else: 

credit_card = input("Credit card number: ") 

save_transaction (prices[choice - 1], credit_card, items[choice - 1]) 

Using a pencil, you were asked modify the two programs so that they use the transact ions . py 
module. You were then asked to write what you think should go into the transact ions . py 
module here: 

det save__trar*sactior*(price, credit__card, des^ip-tior*): 

-file — oper*0'trar*sa ctior*s.t*t”> V0 

tile.y/riteO'7o07d%l^>s7o|is\r* w % (pride ^ lOO, ereditjcard, descriptior*)) 

. ¥ . 

Make sure you use the Code that 

displays the PRICH- tirst 
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test drive 



Once you have completed the exercise, you should have three saved 

files: gym_pos . py, cof fee_pos . py, and transactions . py. You 

can now run the gym_pos . py and the cof f ee_pos . py programs: 9 )^—P os *py 



Python Sh&U 


FjIf frltt P.hiFjl n#bug Hphor^ Winrlnw«i 


jjpjp 


1'ytfron j.lU Acg 18 VfzUiiM) 

ffl-cr 4+11.3] tm liriLEA? 

Type "Copyright"" r "credita'’ or "IiccnactJ" lor more intorrriation 
========================= R ESTABT 

>» 

1 1 uns rosit 

2 . WJlIGHTH 

1 , STRIIS 

■ 1 . IJUlt 

fhnn.ifr fl.fi -ript - . i nri : 1 

Credit card 64:321234 1247021 

1 « TOORKQUT 

2 . WEIGHT 5 
3 « aERGS 
4. Q"Jit 

Choose an option: 4 

I 


dotteejpos.p/ 




Python shols 


Die Ldrt EjiheJI Debuq yptrons fiindcrta 


LSeto 


python J.UI (rJlli 7 HtfU P A.ug iw U/:U 3 : 40 ) 

JftlTr 4 _ l.nj rm 1 ii n i ix 7 

Type "copyriqht" P "credita" or "licenae[)" ±or rrore intcrmation 
>>>-- REGTART- 

_"V V Ti 

1 . DOKUT 

2. LAZTE 

3 y FILTER 

1. miffih 
5 i Quit 

C1 L'_nj.a« djj u£j L lun: 1 

Credit card munirer: /bVJlbJH 5 b 4154^26 
1 . nf>R f [ 3 T 

2 . LATTE 

-u p tuter 

1, HChilM 
5. Quit 

Choo.EE an optione 3 

»>\ 


■L n 1 Qldot: i 


The two programs look like they've worked 
correctly. But what about the transaction file? 
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modular programming 


The transaction file is working great, too 


When you open up the transactions . txt file, you see this 
inside: 


The -Piv-s-t 7 ehav-ad-te^v 
thc p\ri£e. ^ 


The lt> ehav-a^iev-s av-e 
the Credrt tavd Kuimbev". 


The destv-iptiotts -Collov/- (Note 
the e%tv-a yaddmj due to the 
w %|ts w -fov-mat s\>e6-f »e\r.) 



Both of the records, created by each of the POS programs, are now 
correctly formatted. That’s because both programs are sharing the 
same piece of code to save the transactions. 



Looks like you saved the day. 


tWeidte no 

Dumb Questions 



Q: So modules are sort of like 
containers forfunctions, right? 


lt's true that most modules are used 
to store a collectiori of related functions. 
However, it is perfectly acceptable to 
putany code in a module, which is then 
exeeuted wheneverthe module is imported 
into your program. 


Q: So when I use import, it's as if I 
typed the code in the module directly 
into my program? 


Yes, that's a good way to think about 
it. Using a shared module saves you from 
having to type (or cut'n'paste) ali that code 
yourself. J ust import it and it's there. 



Do I have to use modules? 


No, butthe benefit of putting 
shareable code into a module starts to 
pay off the second you use that module 
in another program. Sharing code with 
modules is good programming practice. 
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price break 


The Health club has a new requirement 

The health club boss has a grand plan to get more customers into the 
health club. 


O 





Ooh, I think we need to discount the 
prices in the coffee bar for the next month. 
Theres nothing like relaxing with a latte after 
a tough workout, especially if the price is right. 
Our customers like to treat themselves, so I 
want to make this easy for them. 



The boss has a great new idea. 

The boss wants to cut 10% off all the prices in the 
coffee bar. If it’s successful, he may want to do the 
same thing in other places, such as the gym. 

Instead of just amending the code in the 
cof fee_pos . py file, you need to create a new 
module called promot ion . py that will calculate 
a discounted price. 
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modular programming 



You need to change the coffee bar POS program to apply the 10% 
discount to everything that's sold. You have three tasks. 



Start by creating a new module called promot ion . py containing 
one function: 


def discount (price) : 



Complete the code in the above function so that it returns 90% of the price it is 
given. 



This is the latest version of the cof f ee_pos . py module. Modify it so that it 
uses the new module to cut the price of everything that's sold. 


from transactions import * 


items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 


while running: 
option = 1 

for choice in items: 

print (str (option) + 11 . 11 + choice) 

option = option + 1 
print(str(option) + ". Quit”) 
choice = int (input("Choose an option: ")) 
if choice == option: 

running = False 
else: 

credit_card = input("Credit card number: ") 

save_transaction(prices[choice - 1], credit_card, items[choice - 1]) 


you are here ► 


201 







discount applied 



You needed to change the coffee bar POS program to apply the 10% 
discount to everything that's sold. You had three tasks. 



Start by creating a new module called promot ion . py containing 
one function: 


def discount(price): 

\rc*tu\rr\ O.*) £ p\ridc 


Multi?lyrn^ the ° ^ 

vjill you a I Oh discount» 


O 

© 


Complete the code in the above function so that it returns 90% of the price it is 
given. 


This is the latest version of the cof f ee_pos . py module. Modify it so that it 
uses the new module to cut the price of everything that's sold. 


from transactions import * You Kced *to 

r ,. , o, _■— pom -the '\ronobon-Y1 "' 0< * ule ' 

-rv-oirw p\romo*tior\ impovx ** v 

items = ["DONUT", ,! LATTE" , "FILTER", "MUFFIN"] 
prices = [1.50, 2.20, 1.80, 1.20] 
running = True 


while running: 
option = 1 

for choice in items: 

print (str (option) + ". " + choice) 

option = option + 1 
print (str (option) + ". Quit”) 
choice = int(input("Choose an option: ")) 
if choice == option: 
running = False 


else: 

credit_card = input("Credit card number: ") 

ho/jvidc—disdouh^pv-idcsCdhoidc — 13)^ - 


Youv todt should 
tali w d*»s£oun*tO 
-futtt-borv 


save_transaction (p^^e^-bs^OsLo^^dL] , credit_card, items [choice 

Mvjpr'* Vwj>Hde" is the disdou»ted value the 


- 1 ] ) 
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modular programming 



So what happens if you fire up cof f ee_pos . py in IDLE and buy a $2 latte? 



It looks like it’s working on the screen. What about in the transactions . txt file? Will 
the latte stili cost $2.20? 


The atW ^v-ite 
thav^e is heve- 



No, the latte was discounted by 10% to $1.98, which is exactly what you 
want to record in the transactions file. 


It's time to demo your code to the boss. 
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another discount 




Both kinds of discount? 

It seems that there was something that the boss forgot to teli 
you. As well as deciding to cut the health club’s own prices, he 
also got in touch with his old friend, the GEO of Starbuzz, 
and arranged for a special discount for everyone who shows 
the cashier a Starbuzz Discount Gard. This is the email he 
received back: 


Tu 6* 


GrSSiWSaSfem you! 

. . th Starbuzz discount scheme! A lot of 
■ '<«■ °< course : now wQ,k« a »»>¥«?JSSjg*s!@S 

me 


• Tiiitrninr— 

of the off y a r | l te an ad^Utional 5% discount for every 

.. custompr vv.hopres.eny.a S&g&g». { - 

■' re,Br * a th Hiscount scheme worKs in me 

a " d 

future, we can senY havinq t0 do any work at ali. 


'«di** 


n«i#an 

tw 


« ^nQPndvouanupadieum^- - 

you haviu, .0 do an, wo,k a. a». 
Be well and keep drinking the coffee! 

Your friend, 

Starbuzz CEO 


That’s great news. Although you Ve heard about this extra discount 
late in the day, at least most of the work’s already been done for you. 
You just need to use the Python module the Starbuzz GEO attached 
to his email, and your program will be set up to apply both discounts. 


Let's take a look at the Starbuzz code. 
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modular programming 


The Starbuzz code 


The attachment from Starbuzz was a file called starbuzz.py. 
When you open it, you see this: 


-fcha-fc s-fcav-fc wi-th 
# ave £on>r*c»ls; Py-thoh 

Will ighove -them. 


This is ^ 

disdouvrt -fvAvdtioV) 
as ^vovided by 
Stavbuzi. 


# Official Starbuzz Discount Module 

# Copyright(c) Starbuzz Corporation 

# All Rights Reserved. 

# This function calculates a 5% discount on a price 
def discount(price): 

return 0.95 * price 




The first few lines begin with # characters; these are comments. 
Gomments are just notes added by a programmer that are intended 
to be read by other programmers. Python will ignore them, because 
comments are not code. 


This 'futtttion vetuvns a fvite 
‘fchaVs *?% lowev *thav "bhe pvite i*t 

was <yver\. 


After the comments comes the Starbuzz discount () function. It’s 
just like the discount function you wrote, except instead of returning a 
10% discount, it returns a 5% discount. 

Your code will have to use both discounts: 




It will apply a 10% discount to everything. 


And if somebody presents a Starbuzz Discount Gard, it will also have to 
apply the 5 % Starbuzz discount. 





You need to change the code so that it uses both of the discount () 
functions. Can you see a problem? What is it? 
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identity confusiori 


The two discount functione have the 
same nawe 

Here is the promot ion . py module you just created: 



And here is the starbuzz .py module: 


# Official Starbuzz Discount Module 

# Copyright(c) Starbuzz Corporation 

# Ali Rights Reserved. 

# This function calculates a 5% discount on a price 
def discount (price) : 

return 0.95 * price 


Both of the modules define a function called discount () . So what 
happens when you try to use them? If Python sees a line of code like 
this: 

new_price = discount(1.75) 


which function will it call? The promotion discount? The Starbuzz 
discount? Both? Neither??? 

This is one of the problems of using shared code. Sometimes, there’s 
a function in one module that has the same name as a function in 
another module. When this happens, the last function imported is the 
one used, which has the effect of overloading any existing function 
that has the same name. This can resuit in to hard-to-find bugs. 

So what do you do? 

You need to somehow qualify your function names. 
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Fully Qualified Names (FQNs) prevent 
your programs from gettmg cowfused 


Imagine if you lived in a world where people had first names only: 



Lots of people share the same first name. But people also have 
surnames. If you use a first name with a surname, things are a lot 
less confusing. 


And it’s the same thing with code. If you have two modules 
containing functions with the same name, the computer will get 
confused. But if you fully qualify the function name, by prefixing 
it with the module name, the computer will know exactly what 
you me an: 

promotion.discount(1.75) 


If you are going to use Fully Qualifled Names (FQNs) from a 
module, then you will also need to change the way you import the 
code: 




import promotion 


TWis will impovt the tode tv-om promotionf/ ^ 
bwt to use it, you will need to add "promotion. 



coffee_pos.py 


Now you can fix the code to use both discounts. 
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smarter pos 



Write a new version of coffee_pos .py that, after choosing a menu option, will ask if the 
customer has a Starbuzz Discount Card. If the answer is "Y", apply both the Starbuzz and the 
promotion discount. Otherwise, just apply the promotion discount. 


Here is the latestversion of coffee_pos .py 


from transactions import * 
from promotion import * 

items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running: 
option = 1 

for choice in items: 

print (str(option) + ". " + choice) 

option = option + 1 
print (str(option) + ". Quit") 
choice = int (input ("Choose an option: ")) 
if choice == option: 

running = False 
else: 

credit_card = input("Credit card number: ") 
new_price = discount(prices[choice - 1]) 
save_transaction(new_price, credit_card, items[choice 


1 ] ) 
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modular programming 


VVv-rte 70UV fcode 
heve* 
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getting a promotiori 



fpt\% ExedqSe 

§0{.utl0H 


These are the two discount modules: 




< 


U2i.py 


def discount(price): 

return 0.9 * price 


# Official Starbuzz Discount Module 

# Copyright(c) Starbuzz Corporation 

# Ali Rights Reserved. 

# This function calculates a 5% discount on a price 
def discount(price): 

return 0.95 * price 


You were asked to write a new version of coffee_pos .py that, after choosing an menu option, 
will ask if the customer has a Starbuzz Discount Card. If the answer is "Y", apply both the Starbuzz 
and the promotion discount. Otherwise, just apply the promotion discount. 

Here is the latest version of coffee_pos .py: 

from transactions import * 
from promotion import * 

items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running: 
option = 1 
for choice in items: 

print (str(option) + ". " + choice) 

option = option + 1 
print (str(option) + ". Quit") 
choice = int (input ("Choose an option: ")) 
if choice == option: 

running = False 
else: 

credit_card = input("Credit card number: ") 
new_price = discount(prices[choice - 1]) 

save_transaction(new_price, credit_card, items[choice - 1]) 
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modular programming 


By impo\rfcih<) ihe 

ahsadiiohs module likc ihis, -(Vom .if ahsadiiohs imponi ^ 

you dah dal! ihe -Puhdiiohs 

wiihoui ilie module hame. f. A^.P9Vi.f.Vo^?.'ti?> r ) 

--stajrbuzi 

You heed io use “tV^is kihd oi \ 

impovi 'fov W pvomotioh.py 

ahd w siav-buzzW\ bedause 

you av-e ^ io ^alrfy ibe .iiems. .. =: FpOtfUT", .. TJLTER" . "MWFFIKl 
-Vuhdiioh names v/iib ibe 

module hames. ...?! l^. s ... rr. Jri:5Qi . 7r:7rQ.i .( J. . 

\ruhhih^ =f- T\rue 


l-f someone bas a 
Siavbuz^. Disdouhi 
Cav-d, you heed io 
apply ibe sedohd 
Siav-buz^. disdouhi- 


wbije 


oftioh =1 | 

-fo\r dboide ih iiems: 


py-i r.i^iir(p.pi 1 .?*) rt*. . w *. . w . .i", .^boide) 


opii Oh ~ opii oh + I 


.pvi^i(^iy?(p.pi | .?^'! + ^§uii^) 


dboide ^ ihi(i hfui( U Cb?ose ah.opiioh: /0) 
i-f dboide —— opii oh- 


\ruhhihj ^ False 


else: 


dpedii_day;d ^ .^a^rd fiumbey;: w ) 



p\ride ^ pxp^piiprtdjsjdou^ —13) 

i^- ir\pui( w §iay-bu2JL. ^a\rd? ; 0 =;=■ w Yj 

p\ride =; sia^rbuz^ disdouhi(py;i^c) 


. s ayc3ra^adiioh(pvidc,. dy;edii_da\rd, iiemstdhoide - 13) 
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test drive 



'esT DriI/q 


Let’s try running the new program and buy a SI.20 muffin without 
a discount card. 



1 Pythoni ShoM 


E^le Ldrt EiheJI Uebug Qptrons ^indom 

Python i. 1.1 Aug 1W undJH!)) 

[firCn 4-.1.1] nn 1 1 nux ? 

Type "copyriqtit" F "credita" or " Ilcen.ee \ ) ” for isore 1 n Zo nnatlon 

>»-- ————---REETART 

>>> 

1. D01TUT 

2 . LATTE 

3. FILTER 

4 . miFFTH 
i. Uuit 

C .Iininti jmn npt. 3t:m 4 

Credit card numPeri &■! 1 i Jl i 
fUrfl-rhoa^ir: N 


But what if you try to buy a S2.20 latte using a 
Starbuzz card? 


Ii tosi jl.OQ - 10 % o-f fl .10 


j^s a wuJ 



'Python Shelh 


Die Edit SheJI I^ebug Qptwns Windows 

Python i.1.1 (rill! K-IBO, Aug 1B 2U0y p Uy = 0Js0J 

JRnn 4-1.1] f>n l-Imix? 

Type "copyriqtit" r "credita" or “licenae[J" for rrore Information 
»> —-—--—---RESTART 

3 >> 

i* OOKUT 

2 . LATTE 

3. FILTER 

4 . MC1FFTN 
i. Uoit 

C. htinaif ri n i j|j E. i cui i 5 
Credit card nirmiiers 3413/fahH!) 

St:inrl>u 7 :T irnrdT V 


The code works! With the Starbuzz card, it applies 
two discounts. Without a Starbuzz card, your code 
just applies one. 


lo% of hio - i ne. 

S-fcavbwzi disdount 

o-f -that gives f\.ee\ 


|t’s a latte- 
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modular programming 


The discoimts get the customers flooding in 

Once word gets out that there are double-discounts available in 
the coffee bar, the health club gets packed with customers. 



WeVe never been so busy! The weight 
room, the gym, the steam baths. The 
whole place is full of customers! I like 
the way you write code. I want you to 
upgrade every System in the place! 


Thanks to writing modular code, you got the contract to 
replace ali the health club Systems. Modules help you write 
stable, maintainable code. The more code you write in modules, 
the greater the chance that you’11 be able to reuse it elsewhere. 


Breaking your code into modules turns good 
programs into great programs. 


iWeiare no 

Dumb Questions 


O: I don't get it; why do I need to use 
a FQN again? 


You use a Fully Qualified Name 
(or FQN) when you need to distinguish 
between two functions from different 
modules that have the same name. 

With the health club Systems, the 
discount () function existed within 
your module and within the one supplied by 
Starbuzz. In orderto keepthings straight, 
you had to use a FQN. 


O: So if I hadrTt used a FQN, the 
wrong discount is appiied to the 
purchase? 


A 


I Yes, mostprobably. 

Qj But if I hadn't used a FQN, how 
would I know which discount was used? 


Well... that's the problem. You 
wouldnt lt's hard to predictwhat would 
happen, because itall depends on which 
orderthe code imports its modules. 


Q.: So, ali I need to do is keep an 
on the order when I import modules 
everything will be OK? 


eye 

and 


No, that's notwhatwe recommend. 
Don't rely on what might happen. Use a 
FQN so that you are always in control. 
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programming toolbox 



Your Programming Toolbox 

You've got Chapter 6 under your 
belt. Let's look back at what 
you've learned in this chapter: 


”T* \s 

* Sbrw* Wf 

^ S - , , 4e W ^ ^ 

, . . s oct»^^ ^ . - w a {oV** 3 ^ 

* , Lv. e padA»$ * sc i« i 

a»d tu V Wk , s 

„o4.W T"**"' V sM « \*fc*“* 

* M«M»v «<U •« 

r***- > , 4e \ s v»v* r " r oym 

,. „ o4 u\av t° de 

* Wv»^ ** 

\\V>vav'»e s - (F&Ns) a,rC ^ v,t ^° r ' 

* WH -* 

„a„« 



PytKoh Tools 

* ^ se "^om ... impoiri •*" -feo 

run dode module -Pund-tions 
Wiihout module hames. 

* Use "impov-t ..." i-f you heec | 
t0 *\uali+y youv- Wtion name; 
Vtfi-th a module narne usma an 
W (which is ihe redommendi 
apfroadh in -fche Pyihon 
^ommuhi*ty). 
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Your coding skills are great and getting better ali the time. 

It’s just a shame your programs are not that nice to look at. Displaying prompts and 
messages on a text-based console is ali well and good, but it’s so 1970s, isn’t it? Add 
some green text on a black background and your retro look will be complete. There has 
to be a better way to communicate with your users than the console, and there is: using 
a graphical user interface or GUI (pronounced “gooey”). Sounds cool, but complex, and 
it can be. But, don’t fret; learning a trick or two will have your code ali graphical in no time. 
Let’s get all gooey (sorry, GUI) in this chapter. 
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a host of requests 


Head First TVN wow 
produces game shows 

It’s more than just sports at Head First TVN, as the station has 
entered the lucrative world of live game show broadcasting. 

Their flagship show, Who Wants to Win a Swivel Chair : is attracting 
viewing figures in the millions... not bad for a station that operates 
on a shoestring budget. 

YouVe been approached by their stressed-out (but incredibly 
smooth) game show host to help with a program he needs. TVN 
was so impressed with your work last time that they are offering 
two free, front-row tickets to the Grand Final as payment for your 
work. 



O 


YouVe had a few conversations with the host and determined a 
list of program requirements : 

1. The host wants to be prompted after a question has been asked 
to press either 1 for a correct answer or 2 for a wrong answer. 

2 . Based on the key pressed, an appropriate sound effect needs to 
play. 

3 . The program needs to remember how many answers were 
correct and how many were wrong. 

4 . The host will end the quiz by pressing 0. Then the program 
will display the number of right, wrong, and asked questions. 

Let's flesh out what's required in pseudo-code. 
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building a graphica! user interface 



Use the space provided below to write the pseudo-code for the 
program youVe been asked to write forTVN: 


VVv»-bc 70UV- 
)j>scudo-6odc 
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game show pseudo-code 



You were asked to use the space provided below to write the 
pseudo-code for the program youVe been asked to write forTVN: 


jhurwbcv^askcd — 0 
You v\tt& {& ver*er*bev bow ) 
mahy «yues-tioKs y/cvc asked, '\ mAmbev__do\r\red*t — 0 
bow mair>Y wev-e dovredt / 

and hov/ many v/eve uvong. .. 


ask -tbe bos*t *to pv-ess I -fov- dorv-edt, 2- -fov mdorrefrt, o\r 0 *fco er\d 
Be$» bY askm^ the ^. 

V^osb “to ^ake 3 y/bile *tbe bos*t response is no*t O 

i-P bos*t response y/as I 


add 


TWis W.I 1 W ^ JatW 

v,as ans^eved CORReCTLV. 


I *to number__asked 
add I *bo number^_£orre£*t 
play a sound e-Wedt 
i-f bost response y/3s 2- 


d<Ad 


TWis vnll w .. - 1 nw "' bev ' asked 

't^ e K-* _ x \ add I to numbev_jwvong 

v/as answerea ... J 

incorrbctly. \ p)av a sowr)d e # ed . 


Ask the host at the the host to ^vess j -fov Covvedt, 2- +ov indovvedti ov 0 to end 

end ot eadh loop what 
he wants to do next- 


f mal\y> d’ s ?' a '/ 

the sdoves- 


Doh t wovvy i-f youv answev 
d°esn't look £><ACTL/ like 
this. Thev-e ave a -few ways 
ot wviting the dode- 


display the values ot numbev_asked, numbev_dovvedt and 

vunnbev_wvova on sdveen 
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building a graphica! user interface 


Frank: I think sound is going to be a problem. 

Jim: Sounds easy to me... 

Joe & Frank: <groan>. 

Jim: Sony, couldn’t resist that one. Seriously, though, how hard can 
it be to play a sound from a program? 

Joe: Playing a sound is not the problem; getting it to work on 
multiple platforms can be. For instance, what works on Windows 
might not work on Mac OS X or Linux. 

Jim: That’s not a problem. I only use Windows, so Fll be OK. 

Frank: Good for you, but the rest of us want to play, too, and we 
don’t want to have to... um... eh... downgrade to Windows. 

Jim: Typical: have a swipe at Windows when something doesn’t 
work on your non-Windows computer. 

Joe: Gool it, guys. We need to stop bickering and come up with a 
solution that lets us play sounds and works on Windows, Mac OS X, 
and Linux. And it has to work with Python, too. 

Jim: You mean Python doesn’t support sound as Standard?!? 

Frank: No, not really. In fact, very few programming languages 
support sound in a cross-platform way. This isn’t just a Python 
problem. 

Jim: So... we’re outta luck then. Does that mean it’s time to go 
horne? 

Joe: Not so fast, Jim! Fm pretty sure pygame can help here. 

Jim: So... I can’t go horne early, but I can play games? 

Frank: Seriously, Jim, I think Joe’s right. We can use pygame to 
play our sounds in Python. 

Jim: And it’ll work on Windows, Mac OS X, and Linux? 

Joe: Yes, Fm pretty sure it will. Granted, pygame’s a set of gaming 
libraries for Python, but all we need to use is the bit that handles 
playing sounds. 

Jim: Sounds great. I can’t wait to see it in action. 

Frank: Didn’t you mean “hear it in action”? 

Jim & Joe: <groan>. 
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get in the pygame 


pygame is cross platform 


Before continuing with the rest of this chapter, you need to take 
five to download and then install the pygame technology onto 
your computer. The pygame technology is an example of what’s 
known as a third-party library : that’s extra functionality that can be 
added into your Python environment, but which isn’t part of the 
Standard library 



STOP! Don't proceed with the rest of this chapter 
until you've installed pygame for Python 3 on your 
computer. 


As installing pygame tends to be a very platform-specific 
thing, weVe uploaded a set of instructions onto the Head First 
Programming website for you to follow. 
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building a graphicaI user interface 



Reapy Ba*e 

•*r 

Cope 

Take a look at this handy pygame program, which shows how to play 
four sounds one after another: 


Xsi like v/i-tb otbev 

1'ibvavics, you in>po\rt *bbe 
libvary you wan-t *to use- 


Greate a u py93me.ir*i*e\r ;; obje£-t 
and ini-tializ-e ihe sound sysier*. ^ 


Tbe u y/ai*tjfmisbO w 

-fund*tion loops un*til *tbc 
cbanncl^s ^etJmsyO” 
me^bod vctuvns False. 


Tbe valuc v-e-tuv-ned -(ron» ^ 
■ibe w playO” rwctbod geis ** 
passed "to %*ait -finisbO w . 


import pygame.mixer 
sounds = pygame.mixer 
sounds.init() 


def wait_finish(channel): 

while channel.get_busy() 



pass -- 

s = sounds.Sound("heartbeat.wav") 
wait_finish(s.play()) 
s2 = sounds.Sound("buzz.wav”) 
wait_finish(s2.play()) 
s3 = sounds.Sound("ohno.wav” ) 
wait_finish(s3.play()) 
s4 = sounds.Sound("carhorn.wav”) 
wait_finish(s4.play()) 


Tbe U 5ctjbusy0 w 

eibod cbedks *to 
see i-f *tbe sound 
is stili playing. 


? ass” •« a 
docs no-tbincy 


Load in -tbe 
sound -file you 
want io play. 

Idenii-fy and play 
caeb o-f ibe sounds. 



To run this program on your computer, you obviously need pygame installed and y ou 
need to download the sound files for this chapter from the Head First Programminc/l 
website. Be sure to put the sound files in the same directory/folder as your program. 
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test drive 



YouVe successfully downloaded/installed pygame and grabbed a copy of 
the Head First Programming sound files for this chapter. Now, test the pygame 
program in IDLE to see if things are working correctly: 


ready.py - /horna/barryp/p_&OLjnds/ready.py 


File Trirt rnrmat rtun Qptinnt Wmrlnw^ 
pygaiM.mixcr 

.*-■ ■: :>Li Jit I x = jjytjri mM - m i ae-: j 

sounda,init[) 

»• ■ wait_fxni Bh [ctian nel): 

(zhn 1 j. gs f hunyi): 



s - aounda.Sound( "heart&eat,wav“ J 
wait_finiab(a.ptay()) 
s2 aounds .Sound( "13U2 z .vrav ) 

wait_f inia-b (a2 ,.play ()) 

3 3 = aounda. Sound ( " o nr.o. wav' ] 
wait_finiab{al.play()) 

3 4 = aounds. Sound ^ M c arborn _ r -av" j 
wa.it f inmh ( n4 -play ()) 


Sounds like pygame is up and running! 


\ / J 

' Thump! _ 

' Thump! - 

r , ^ 







tao'1 

r»d 'wi 

i -briAst 
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O: So pygame is a library created 
by some programmer other than the 
Python folks? 


Yes, it's what's called a third-party 
library. It wasn't created by you or the 
people that bring you Python. Some other 
programmer(s), a third party, created 
pygame. 



And it's just given away for free? 


Yes. Which is very nice of them, isn't 
it? 


Q: Are there other libraries like 
pygame that can be added into my 
Python environment? 


Yes, there are lots. To see the current 
list, follow the Package Index link from 
the main Python website. Python refers to 
third-party libraries as “packages" and, as 
youll see, there are packages available for 
every conceivable purpose, notjust playing 
sounds or developing games (as is the 
case with pygame). 


O: The sounds I downloaded are 
WAV files. I know that WAV is one of the 
standards forencoding sound, butis it 
the best format to use? 


Thatdepends on who you ask! We 
are using WAV files because they are used 
in lots of places and are well-supported on 
most operating systems. There are lots of 
file formats for sound and many of them 
claim to be "better"than WAV, but for what 
we are doing here, WAV is perfect. 


t Jiereiare no 

Dumb Questions 


O: What's the deal with the wait_ 
finish() function in the Ready Bake 
Code? I just don'tgetwhy it's there. 


lt's a function thatwaits for the sound 
to finish playing before continuing with the 
restof the program. 



What?! Surely the sound just 


plays? 


Playing with pygame in this way, 
although fun, masks a problem that can 
surface when working with sound (in any 
programming language). Itturns outthat, 
when asked to play a sound, the main chip 
inside your computer (the CPU) doesn't 
even bothertrying. Instead, there's another, 
smaller chip in your computer that is 
specifically designed to play sounds and 
it is to this chip that your main chip hands 
the sound file to and says: "play this for 
me." The main chip then goes back to 
running your code, sees another request 
to play a sound, doesn't bother, hands 
the new sound file offto the sound chip, 
and repeats until your program ends. The 
sound chip-and this is the important 
part-is designed to operate in parallel 
with your main chip. While your main chip 
is doing something else, the sound chip is 
busy playing any sounds it has been asked 
to play. And-here's the rub-if the sound 
chip has been asked to play more than one 
sound, it attempts to play each sound at 
the same time. 


Q: So the wait_finish() function is 
like an artificial deiay after each sound? 


No, not really a deiay, more like a 
pause designed to let the sound effect play 
fully before trying to play anything else. 

The wait_f inish () function forces 
your sound chip to finish with one sound 
before starting another. Whathappens is 
that when a sound is played, the play () 
method passes back the channel (or track) 
numberthatthe sound is playing on. You 
can then use the channel number to ask 
pygame to waitforthe channel to finish 
playing a sound before continuing, which 
is what the code in the Test Drive on the 
previous page does. 


O: And if I don't use wait_finish(), 
what happens then? 


AII the sounds attempt to play at the 
same time and it sounds like a jumble of 
sounds as opposed to one sound playing, 
then another, then another, and so on. 
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beyond pseudo-code 



£orfg EmciSe 


Now thatyou know how to generate a sound using pygame, it's time to write the code for 
TVN's program. Base your program on the pseudo-code you created earlier. 
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on with the show 



p> h£ E xe aci Se 
Solutio M 


Now that you know how to generate a sound using pygame, it's time to write the code for 
TVN’s program. You were to base your program on the pseudo-code you created earlier. 


Vou r\tt& "to 

Deames Vi*ev’ "' odwle 
m oydev t» ?lay ^ds. 




impo\rt 


dc-f wait 'Pinish(dhanneP : 

^ io " ko* y/hile tbarmeUel busyO: 

earlier. . 

pass 


Cv-eate a rwiTccv objedt 

and initiali z£ the - 

py^ame sound system. 


sounds =■ pyjamC.imi^CV- 
sounds. initO 



Load eadh o-f -the 

re^ui\red sounds in-to iis ^ dovrefctjs =■ sounds.£ound( W do\r\redtv/av ) 

own vaHablc. w „ 

wvon^__s ==■ sounds.Soundt v/v-onjv/av / 

Tbis is whai you II 
ask the ^uesiion 

^ prompi — U p\rcss I -fo\r Co\r\redt, 2- -fo\r tV\ron<J, oirO io $uii : W 

Make swve "the fcowfe tbat 

yow’ll n>ai«-ta«n ave set xo a 

v-easo»»able starb»* «a»* ^numbcv^askcd — 0 

numbev-__do\r\redt — 0 

Ii v/ould be 0^ io move these (jr\urnbev*__vv\ron<} ==■ 0 
ihvee lines o-P £ode io the iop 
o-r the pvocyram, jusi so long as 
they Kave siarting values be-Pore 
the while loop siavis. 
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Prorupi the hosi- 


^ ipu*t(pr P.^. 


\A/Wilc i^e ^3 mC y/lii|c djioidcj^'O 1 - 
V^as^i erded- 

dboide ~~ 'I ; 

l-f ibe ar\sv/cr is 

dorv-cdi, ’mdv-cmcr>i ibe. . + [ . 

douniev-s a*d iben play 

ite appropriaie sour>d. ^^cr^orrcdt ^ + I 

w<a ii_f i ni sb (d orrcdi_s. play 0) 


l-P ibe answev- is 

mdorrcdi, ir\dv-er*eni 

ibe dounicrs and play 
ibe sound e-f-fe^i- 


i;£ dboide ~ '2- 1 ; 

r>ur^bc\r_askcd ==■ .*^ber_asked + I 

hu^bcr_wronj =7 nurnber_wron^ + I 

Nyaii^-fmish f vyrong^s. p lay ( )) 


dhoide ^7 A^P.^PJTP.^Pt). 


At tKe e»d tKe ^a», 
displa^ a summary oi t c 
dounier valucs. 



prmi( u you asked ” + sirUurwbc\r__askcd) + u ^ucsiior\s , 0 

prinifsirfnumber_Correci) + w v/ere dorredily ansv/ered”) 

prini(sir(number^v/ron<j) + u v/ere ansv/ered indorredily/O 
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test drive 



Type your code into IDLE and save it under the name gameshow. py. 
With the Head First Programming sounds stored in the same directory as your 
program, press F5 to give it a spin. 




File rrlit r «heJI Jfrhuf] Gplmn^i Winriow ! ; 



rythem 3.1,1 (r311:744&B F Aug LB 2003« D7s 
JGCC 4,5.3] un linujc2 

TyP e "copyrigtit" r "cicdUta" or " liccnoc ()' 

lor 

jp «p jp 








nLJ! . rl.t: = — 

»> 











Fresa 

1 

for 

Corree t x 

2 

for 

Wrong. 

or 

c 

to 

Qu it: 

Frese 

1 

for 

Corroctj 

2 

for 

Wronq F 

or 

& 

to 

Quit: 

F res a 

1 

for 

Correo t r 

2 

for 

Wrong p 

or 

0 

to 

Quit: 

Frese 

1 

for 

Correot* 

2 

for 

Wronq r 

or 

0- 

to 

Quit: 

Fresa 

1 

for 

Correot r 

2 

for 

Wrong r 

or 

G 

to 

Quit : 

Frese 

1 

for 

Corraot, 

2 

for 

Wronq r 

or 

0 

to 

Quit: 

Fresa 

1 

for 

Correot r 

2 

for 

Wrong F 

or 

& 

to 

Quit : 

F rese 

1 

for 

Correot f 

2 

for 

Wronq r 

or 

Q 

to 

Qu it : 

Fresa 

1 

for 

Correotj 

2 

for 

Wrong F 

or 

G 

to 

Quit : 

P res 9 

1 

for 

Correct, 

2 

for 

Wronq r 

or 

0 

to 

Quit: 

Fresa 

1 

for 

Correo t , 

2 

for 

Wrong F 

or 

G 

to 

Qu i t: 

Press 

1 

for 

Correet, 

2 

for 

Wronq r 

or 

0 

to 

Quit: 

Fresa 

1 

for 

Correo t r 

2 

for 

Wrong F 

or 

0 

to 

Quit: 

F res s 

1 

for 

Correet. 

2 

for 

Wronq r 

or 

G 

to 

Quit: 

Fresa 

1 

for 

Correot , 

2 

for 

Wrong„ 

or 

G 

to 

Quit: 

tfou aerted 14 

queetions , 







1 Q wrt rr 

rnn 

■in-nt 1 y rtin.nrrTr d . 






1 war e 

in sver e d ineor rec tiy . 






1 Mt tar/t slr^ow 
sounds 
ci-bKcv-, so 50 
ahead air\d ru* 
•the \>v"o<yra** *to 
heav- i“t yiorkmj 
-fov youvsel-C- 
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pygame 

This week’s interview: 

Is itfun being pygame? 


Head First: Helio, pygame. Nice of you to join us. 

pygame: Helio. Thank you so much for giving me 
this opportunity to discuss my situation with you. 

Head First: What situation is that? 

pygame: Well, you know, just because Im used for 
gaming, everyone expects me to be fun all the time. 
Life and soul of the party... never stopping to smell 
the roses... always on the go. <sigh> It’s all too much 
fun, really. 

Head First: Too much fun? Really?!? 

pygame: Well... yes. Not a lot of people know this, 
but my life as pygame is hard. Not only do I have 
to help out regular folks with their programming 
problems, but there’s all those gamers, too. Some of 
those guys never sleep... it’s just play, play, play, play, 
play, play... I’m simply exhausted. 

Head First: Oh, sorry to hear that. But, don’t you 
feel good that all those programmers out there in the 
Python community are using you? 

pygame: I guess so. 

Head First: You Ve made a lot of programmers’ 
lives easier. There’s lots of great code written that 
would not have been written if it weren’t for you. 

pygame: Yeah, right. I do all the heavy lifting while 
everyone else is off doing other things. 

Head First: Ah, come on, your life’s not that bad, 
is it? 

pygame: <sighs> 


Head First: Surely you know what people are 
saying about you? 

pygame: Now they’re talking about me, too? How 
awful... <sobs> 

Head First: Yeah, there’s lots of talk, but it’s all 
good. The Python programming community loves you, 
pygame. 

pygame: They do? <sobs even more> 

Head First: Yes. You are well-tested, well-written, 
and your documentation is first rate. Your support 
for all the major releases of Python is right on the 
money, too, and you work on Mac OS X, Windows, 
and Linux. 

pygame: All IVe ever tried to do is keep everyone 
happy. 

Head First: And you do. We’ve heard so many 
great things about you that we are recommending 
you to all our friends. 

pygame: Do they play games? Fm good at that, you 
know. 

Head First: Yes, some of them do. But others just 
talk about the great things their applications can now 
do thanks to you, pygame. 

pygame: I guess things aren’t quite so bad after all? 

Head First: Not at all. We’re big fans! 

pygame: Why, thanks. That’s awesome. Do you 
have time for a quick game? There’s this new 
Dungeons and Dragons that IVe been dying to try... 
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dated interface 


0 ... Z... 1 ... 9 ... blast off! 




Your progranVs looking pretty dated. 

The program works, but it’s not going to win a Visual 
Design Award any time soon. And its use of key presses 
makes it a little hard to use, too. 

So, its looks could be improved and its usability could be 
better. 

It sounds like you need a graphical user interface , or GUI. 


i 

Mosi pcoplc pvohouhdc 6jUI as w gooey " 


230 Chapter 7 


building a graphicaI user interface 



You need to design the look of your GUI for TVN. Draw what you 
thinkyour GUI should look like in the space provided below. 

Hint:Take some time to think about other GUI programs that you 
have used. Think about a common interface element that you 
could use (and draw) here. 
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interface facelift 


r fciharpen your pencil 



You needed to design the look of the GUI for TVN. You were asked 
to draw what you think your GUI should look like in the space 
provided below. 

The hos* wi|| 

by dlosmg £ he wiMdow 3 


Pvess -tWis taU»" 

Ue» -tbe answev 

is tovvedt 



P * ss buUon 
w ben ihe a»sw t<c 

' s Wlrohg. 


You r\ccd tvio buttons 'f°' r 
e atV> ot yowv yvogv-a» s 
even^ts- 
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building a graphica! user interface 


Frank: Since when have you been an expert on GUIs? 

Jim: Isn’t every Windows user? 

Joe: Well, of course, everyone knows how to use a GUI, but we are 
talking about creating a GUI in code. 

Jim: Ah... oh... um... eh... now, where shall we start? 

Frank: It turns out that writing code for a GUI applicatiori is... 
well... just like writing any other code. If you know how to program, 
you know how to create a GUI. It’s just a matter of selecting the 
correct GUI library, learning how to use it, then writing the code. 

Joe: So we’ll head off to the Python Package Index and grab us some 
GUI libraries, eh? 

Frank: Not so fast. Python comes with a GUI library as Standard, 
called tkinter. 

Jim: tk-what? 

Frank: tkinter. The “tk” bit refers to the fact that Python’s Standard 
GUI library is built on top of the very popular Tk technology. The 
“inter” bit is short for “interface.” 

Jim: So we’re going to build a GUI interface in Python running on 
Tk using tkinter? 

Frank: Yes, we are. That’s not too confusing, is it? 

Joe & Jim: Well... not if you say so. 

Frank: The big thing with creating GUIs is understanding the event 
loop. 

Joe: Ah, that’s just looping code that reacts when certain things 
happen, isn’t it? It’s just like the while loop in the non-GUI version 
of TVN’s program. In that code, that loop is an event loop, isn’t it? 

Frank: It sure is. Although the GUI event loop tends to be extra 
capable and can do lots more than the simple while loop. 



/ 


Joe: That sounds complex. Is it? 


Frank: No, not really. It just takes a little getting used to. 


Jim: But, it’s all just code, isn’t it? 


Frank: Yes, Python code using the tkinter library. 


Joe: OK. Let’s get to it, since we already know how to program... 
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tkinter event loop 


tkinter gives you the event loop for free 

In order to process events efficiently, GUIs employ an event loop. Event 
loops watch and wait for events, calling a piece of code each time an 
event occurs. If you think about the current TVN Game Show program, 
it already has a very basic event loop that waits for the host to press 1,2, 
or 0. The program then calls some code before waiting again for another 
key-press event from the host. To implement this in code, you used a while 
loop: 


while choice != '0': 
if choice == '1': 


number_asked = number_asked + 1 
number correct = number correct + 1 


In tkinker, you don’t need to write a while loop like you did for your 
non-GUI program. In tkinter, call the mainloop () method instead: 


Clidk Oh -the dlosc 
box to tenuate 
this appliia-ti 


mpovt evevything Wom 
the tkihtev module- 

V 

from tkinter import * 

Oeate a tkintev aj?l*aW 

app = Tk () ^ wihdow 63lled 

app.title ( "Your tkinter application") 
* app.geometry('450x100 + 200 + 100 ' ) 

provide wihdow 

Stav-t “the tkihtev- evehi loop. 


Your tVink«T Applicatum 


^ive the 
wihdow a 
hame. 




TKese W lines o£ 
1+^’ python/tkintev- tode 
pv-odute +V\is QM' 


app.mainloop() 


siz-e 


va lues- 


:ioh. 


- □ K 



To add a button to your application, use code like this, being sure to put 
these two lines of code before the call to mainloop () : 




bl = Button (app, text = "Click me!", width 
bl.pack() 


Add a bu-tioh io 

the wihdow and give 
it some texi and a 
width value. 


The yatkO method li*ks 
■the neu/ly dveated button 
to the e*istmO| 'w'ndo'w. 


= 10 ) 


rte button s been 
added to the $Uf. 


Ymir tkinter applicatum 
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tkinter is packed with options 


The pack () method lets you position the button in the application 
window. If you provide a value for the side parameter to pack (), 
you can control where in the window the button appears. Here are the 
legal values for side: 


o 

o 


pack(side = 'left') 

Position the button on the left side of the window 
pack(side = 'right') 

Position the button on the right side of the window 

pack(side = 'top') 

Position the button at the top of the window. 

pack(side = 'bottom') 

Position the button at the bottom of the window. 


value o£ w sidc" 
tonh-oh where -the 
bu-ttoi, is paeked. 




It is also possible to add some padding around buttons (to make them 
look nicer in your window): 



pack(padx = 10, pady = 10) 

Position the button with 10 pixels padding on ali four sides. 


_ ^u^rpen your pencil 


Based on what you now know about tkinter Windows and 
buttons, write the code to display the GUI that you need for the 
TVN program: 
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gooey display 




Based on what you now know about tkinter Windows and 
buttons, you were to write the code to display the GUI that you 
need for the TVN program: 




Credit ‘the wmdoNw as 
m i be tdr\\tr 
bu*t tbar^e i be wmdow 
trtlc 3hd yometv-y 
values. 



app=-Tk() 


app ; ili)c.( ?TV!V . .^a^c Sbov/0 


ayf.-acometry tyQQ*^QQi?rQQi!Q.Q , ). 


Cnaic a M?fc» &». . 

Corrcti. eveni.. ~~~ jjj — Buttor/apfy . "Correti!", vi/idhth. .77. i.P). 



bl.padk(side =; 'lettV pad* . =•. .10, pady ^ 10 ) 


Pa£k o^c butfcoh 
Oh tbe le-ft, tbc 
otbcv- oh tbc v-igbt^ 
ahd jive "tbem some 

faddihj. 

Cvcaic anotbev Wtt®*» y . bZ.padk(side =- Vic^i', pad* = . 10, pady. =: . 1 0) 


bZ =■ Bu.iWapp;. Fr. /Wv. 9 ^. 9 ! widtb 10) 


S*ta\rt *tbc cvch*t loof- app.rhaihloopO 
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'esT DRive 


Let’s take your first GUI program for a test drive. With your tkinter code 
entered into IDLE, save it as tvn . pyw and press F5 to see how it looks: 


y<?uv dodc ifi |PL-£ 


Tkcvc S d fconvention m Python 

xwoy-ld that su^esb tkwtev 

v/i-tv. a e*te«sio«, 

as offosed -to be wswal fy • TWis 
V>elfs youv opevatm^ system vun yowv 
•Ucm-tev fvoyaws pvopevly, espedially ov. 

Mndov/s. 


tvn.pyw ■ /home/barryp/p sounds/tvn.pyw 


File Edit Fomnat Run Options Windows 


_ n x 


Help 


from tkinter impor: * 

app = Tk() 

app,title( "TVN Came Show") 
app.geometry( 1 300x100+200-100 1 ) 

bl = ^utton{app r text = 'Correcti r width = 10} 

b 1 - pack (□ idc — ' Icrf t ' j padx - 10, pady - 10) 

b2 = Button(app f text = "WrongJ", width = 10) 
b2.pack(side = ' rignr , padx = 10, pady = IU) 


app.. ma ini o op ( ) 




T~Kcv*c s youir ^U| wihdow. 


TVN Game Show 


Lookm^ $ood> ck? 





...a«d bteve ave 

youv 'two bwtxons. 


That's one nice, professional-looking GUI! What do the 
people at TVN think? 
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beauty without brains 


The (rUI works, but doe$w't do awythmg 



Nice interface, but it doesn't work. 
When I click on a button, nothing 
happens... I don't hear anything. What 
happened to my cool sound effects? 


The graphical user interface might 
be ready, but the program is not 
complete. 


tlierei<ire no 

Dumb Questi9ns 



So all tkinter gives me is the ability to draw the GUI? 


Well, yes, but there's quite a lot of functionality wrapped up in 
thatsmall numberof lines of tkinter code. 


O: Thatpack () method looks a little weird... how does it 
know where to putthings? 


The pack () method adopts a best-guess approach when 
it comes to packing your GUI widgets within your GUI application 
window. This usually works out, and when it doesn't, pack () 's 
parameters give you some control over the situation. 



That's all that left, 


stuff, isn't it? 


right, top, and bottom 


Yes, as well as the padx and pady parameters. They 
help with widget positioning, too, by putting additonal space (or 
padding) around your buttons. 


O: OK, I get that, but how come nothing happens when I 
click on my buttons? 


Ah, funny you should ask that... 
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Cowwect code to your buttow evewts 

When you click on a button, the tkinter event loop captures the event and 
looks for something to do with it. The trouble is, as your program stands, you 
have not detailed what that something to do is. Your buttons have no code 
associated with them, so the events occur but go unnoticed. To connect code to 
buttons, put the code you want to run in its own function and then name the 
function in the button code by providing a command parameter: 


Identi-Py -the -Punetion to \run v/hen 
the button is dieked- 


b = Button(app, text = "Click on me!", width 
b.pack(padx = 10, pady = 10) 



15, command = button_click) 

\ ) 




Cveaie a tuinfction "to tontain 
•the tode that v-uns \whe»> the 

event od£uV"S. 


def button_click(): 

print("I've just been clicked!") 



-tii 


jutt.pyw ■ /hem*ybarryp.'p_£oiirkdG l 'ftiJ 


Cum Optioro Windows 



app - tk [5 

npp * t: i tl r ( H f! 1 i rlr nn rvr- H \ 
app rqeomfitry [ " 1 00 x. l o 0*2 00 1 o Q 1 L 


d€ £ Dirttem_c 1 ici: [ J i 

print ( “ I 1 vc Juat deen dicfccd I" ) 


b - Dut-toni; cpp* text - "Click on mc ! , width — 15 1 command 

n _ pauk ( pn-Lx = 10, l' . ■ J y = lC»j 



nppr ri i 131 1 ai i: i i | 


FiIp ISflit r.hHI ryphiiQ nptinn^ Winrinw 1 ! 

1 'ythlm iri. 1 (rUl:^4U0| ftug 1B iiuoy, uysU3:4i) 

[ftcrl i. u.l I rara lEniaxZ 

'lypcl-Copyright" F "credito" or "liccnoc [ J" tor more intormation, 
Aj=== =========================== RTl.STAKT 

»> 

T ' vf. J u?a I tiKKn c“ 1 i cilii-*i S: 
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making connections 



The code from the nongraphical version of theTVN program is on 
this and the facing page.Take your pencil and mark the parts of 
the code that you would extract and turn into functions so that 
you can then connect the functions to the buttons in your GUI. 
Mark the other parts of this program that also need to be added 
to the GUI version. 


The nature o£ the 
mtev-Cate provided hy the 
£jU| means that some o£ — 

the proyam s re«\uirements 
have than^ed- 


Note: Don't worry about prompting the host to ask a question in 
the GUI. But do worry about maintaining a count of the number 
of questions answered correctly and incorrectly. (The total count 
is not important, either.) 


How many functions do you think you need? Write their names here: 


import pygame.mixer 

def wait_finish(channel) : 

while channel.get_busy(): 
pass 

sounds = pygame.mixer 
sounds.init() 

correct_s = sounds.Sound("correct.wav") 
wrong_s = sounds.Sound("wrong.wav") 

prompt = "Press 1 for Correct, 2 for Wrong, or 0 to Quit: 

number_asked = 0 
number_correct = 0 
number_wrong = 0 
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choice = input(prompt) 
while choice != '0': 
if choice == ’1’: 

number_asked = number_asked + 1 
number_correct = number_correct + 1 
wait_finish(correct_s.play()) 
if choice == ’2': 

number_asked = number_asked + 1 
number_wrong = number_wrong + 1 
wait_finish(wrong_s.play()) 
choice = input(prompt) 

print ("You asked " + str(number_asked) + " guestions.") 
print (str (number_correct) + 11 were correctly answered. ") 
print(str(number_wrong) + " were answered incorrectly.") 


With the code you need identified, take the time to update 
your GUI applicatiori with the new functions and whatever 
other code you've extracted from the non-GUI program. 

Produce a new program that is a combination of your existing 
GUI code and the extracted code from this program. 
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page goal header 



You were to take your pencil and mark the parts of the code on 
the previous (and facing) page to identify the code you would 
extract and turn into functions so that you can then connect the 
functions to the buttons in your GUI. You were also to mark the 
other parts of this program that also need to be added to the GUI 
version: 


You were to think about how many functions you might need. You 
were to write their names here: 



You need 3 -Cuneiion t> 
^lay 3 sound wViCn “the 
answev- is eorvcfct— 


play_dovredt_soundO 

p ldy_J wv-ong^soundO 


•••3nd anotiev- -Puneton 
■fco play a sound v/hen -the 
3nsy/e\r is wv-ong. 



The £jU| pv-oy-a** stili 

needs *bo use py^ime. 



correct_s = sounds.Sound(”correct.wav") 
wrong_s = sounds.Sound("wrong.wav") 

prompt = "Press 1 for Correct, 2 for Wrong, or 0 to Quit: 



You stili need *to main-tain 
-these toun-tev-s. 
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choice = input(prompt) 
while choice != '0': 


if choice 


1 


nnmhprpqVpH = mnnb>^T + 1 

number_correct = number_correct + 
it_finish(correct_s.play()) 


if choice == 1 2 1 : 

number asked 


^—^Tuv-k -tKis todt 'm*to 
w D|aYJtorrcC-tj5ou^ ^ 


number asked + 1 


number_wrong = number_wrong + 1 
Lai t_f inish (wrong_s .play () ) 
choice = input '(prompt) 


print(”You asked 11 + str (number_asked) + ” 


-this iode m-to the 

P«y_\«vohg L _souhdO" 

TUhfrfcio*. 



pisflaym^ 
sumr^av-y \rcma'ms a 

“too- 


With the code you need identified, you were to take the time 
to update your GUI applicatiori with the new functions and 
whatever other code you've extracted from the non-GUI 
program. 

You were asked to produce a new program that is a 
combination of your existing GUI code and the extracted 
code from this program. 


Tm, the page the 
«pdated code solutio*... 
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button press rehearsal 


The (rUI prograw'$ wow ready for 
a screewtest 

Here’s what your GUI program should look like now: 


from tkinter import * 

import pygame.mixer 

sounds = pygame.mixer 
sounds.init () 

correct_s = sounds.SoundCcorrect.wav") 
wrong_s = sounds.SoundCwrong.wav") 

number_correct = 0 
number_wrong = 0 

def play_correct_sound(): 
global number_correct 
Python s globalnumber_correct - number_correct + 1 

correct_s.play() 


keywovd le*U 
you adjus-t *tbc 
valuc assodia-tcd 
y/i-tb a vaviablc " 
Cct &ted outsidc 
-tbc £uir\d'tio)r\. 


def play_wrong_sound(): 
global number_wrong 
number_wrong = number_wrong + 1 
wrong_s.play() 

app = Tk () 

app.title("TVN Game Show") 
app.geometry('300x100 + 200 + 100 ' ) 


bu-tfcons ave now 

tometled io evehi- 
bahdlih^ PhCiiohs. 


bl = Button (app, text = "Correcti", width = 10, command = play\correct_sound) 
bl.pack(side = 'left', padx = 10, pady = 10) 

b2 = Button (app, text = "Wrongl", width = 10, command = play_wrong_sound) 
b2.pack(side = 'right', padx = 10, pady = 10) 

app.mainloop() 


print(str(number_correct) + " were correctly answered.") 

print(str(number_wrong) + " were answered incorrectly.") 
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With the code you need extracted from the nongraphical applicatiori and 
added to your GUI program, press F5 in IDLE to see (and hear) if things are 
working any better now: 


\ > / 

Tmg! 

I \ 



tvw Show 



|-t noi only l°°^ s 

aood, bui 'ii 
sounds opoAi ioo. 


Every time you click on a button, the appropriate sound 
effect is heard. Great work! 


tliereifire no 

Dumb Questipns 



So “event handlers" in tkinterare justfunctions? 


Yes, as we said earlier in this chapter: it's all just code. And 
by putting the code you wantto run in a function, it's easy to 
reference it using the command parameter associated with each 
button. Your user clicks the button to run the code in your function. 


This actually isn'ttoo hard. I always thought building a 
GUI was only foradvanced programmers? 


Well... thatcertainly used to be the case, but things have 
changed (for the better). Technologies like tkinter allow every 
programmerto build great-looking GUls withouttoo muchfuss. It's 
a case of tkinter concentrating on the GUI, while you concentrate 
on yourcode. 


Q.: And is it the case that, if I wantto add other things to my 
GUI program, it's done in a similar way? 


A 


I Yes, all you have to do is write the code. 

And I connect my code up to my other things using 
something like the command parameter that works with 
buttons? 


Yes, that's all there is to it. The mechanism for the other 
interface elements (or widgets, forshort) mightbe a little different, 
butthe conceptis the same. Once you can work with one, the rest 
are a lot easier to get your head around. 
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missing results 


Put TVN is stili not happy 



The results appeared in the Python Shell, 
not in the GUI, so the host missed seeing 
them. When you point this out to him, he’s 
less than impressed and makes it ciear that 
he expects the results to appear in the GUI. 

You need some way to display 
messages in the GUI. 


The results are 
n<^ht there m the 
Python Shell But 

-th\s is NOT Vihat 

the host w3nts- 




Python s ho 


|_ile Ldit LiheJI liebug Uptions ^dmdow5 

Python 3 . 1,1 [r31H7H0O, Auq 18 2000, 07:03^.3-) 

|GCC 4 . 3 i]>| on 1 inuit 2 

Type "copyrlqTit", "credita" or "lleenaefj" for nuore Information 
>» --------— RESTAEtT 


iLi vcrc corrcctly nnawcrccl. 

1 WMff rtn mwkb «13 L miiir t y_ 
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* + 

- + - 

The interface elements that you add to a GUI are known as widgets. 
YouVe met one already: the button. There are lots of others. Look at 
the names of some other widgets below and see if you can match them 
with the correct description. WeVe already done the first one for you. 



A widget that provides a way for large and 
small amounts of text to be entered 


A separate window that pops up to request 
additional information from the user 


A widget that displays a string message in 
a window 


The combination of a drop-down list and 
a text box 


A widget that allows you to select one item 
from a large list 


Dlalog box 


A list of command options that is attached 
to the top of a window 


VVvite youv Which widget do you think you need to use in your program? 

answev \\trt 
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label it 



The interjace elements that you add to a GUI are known as widgets. 
You’ve met one already: the button. There are lots of others. You were 
to look at the names of some other widgets below and see if you could 
match them with the correct description. 



You were asked to identify which widget you would use in your program. 


Use *tbe “Label” widget 

You *eed -to add a label to your <$U| 'm 
ov-der to display tbe v-esults- 
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label it 


When it comes to adding a label to your GUI, use the tkinter Label widget. 
You create it in code not unlike the way you create a button. Here’s the code 
to add a label to an existing GUI application. The label simply displays a 
string: 


C^cottc a kcw label» atta^b 

'\i -to -the r*am Wmdow, yve 
'rt some a*d adjusi 

labcl^ beijbt 


1 = Label(app, text='When you are ready, click on the buttons !', height = 3) 
1.pack() 


Doni tonget to paekO the widget 



Put the label tode beW 
tbe tode tor tbe buttons 
and tbe £)W| will tben look 

likc -tWis. 


Another variation replaces the text parameter with textvariable. If 
you assign a special tkinter variable to this parameter, the label will change 
whenever the value of the variable changes, automatically\ 


Cv-catc a y \ 'InWav 


h/ 


Assoeia-te_ 

"tbe “/ntl/av-" 
with -the 
label- 


num_good = IntVar() 
num_good.set(0) 


11 = Label (app, textvariable = num_good) 
11.pack(side = 'left') 


num_good.set(100) 



M ; e ih Z -etbod io adjus-t the 

value ot -the Intl/an", and the <$UI 
updates, as it by «,agie. 





Utlng an intV&rO 



Utlng an lnlWr() 
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add labeis 



fjoitfg EmciSe 


Based on what you now know about adding a label to a GUI, 
rework your GUI code so that it uses two labeis. One should 
display the number of correct answers and the other should 
display the number of wrong answers. We've left plenty of room 
for you to write in all the code that your program now needs. 
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label results 



ExeRciSe 


Based on what you now know about adding a label to a GUI, you 
were asked to rework your GUI code so that it uses two labeis. 
One should display the number of correct answers and the other 
should display the number of wrong answers. We left plenty 
of room for you to write in ali the code that your program now 
needs. 


Stavt by iiKfortmJ the tkmtev impo\rt ^ 

libv-avy lodt you necd- ') 

impovt j>y^arnC.mi%e\r 


Create the two 
eveht ha*dlers 
that set the 
livfcVar a*d play 
the appvopviate 
souhd- 



de-f play^dov-\redt_souhdO: 


hur^^oodset^um^ood-jetO + I) 

dov-\redt_s.j>layO 


de-f E^)L» W0 ^3LJ 50Uh ^^ : 

r\um_badset^um_bad.3et0 + I) 


^°»a_s. P layO 


app ==■ TkO 

&***#* - app-t'rtle("T\/N Show") 

appkatio* wmdow. . '- 1 . 

99 !?. 


I^itialize the 
souhd system. 



souhds — pyjamemi^ev 


souhds.mitO 
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. a j ( toYYttb s sour\ds.£our\dO'dov-redfev/avO 

re^uirea souhd *_^ J . — . . 

woy\<^_s :=■ sour\ds.£our\d^ w y/\rohOj.y/av w ) 

Oeafee fewo 
ln-tVavs 1 one -to 

f.ount tV>e rmAot* nwm_<}ood — |n-fc\/a*-0 

of tovretl ar^evs 

a«d a»otV*v ±0 ^ 

*r t 

of v/vov^ a^s^cv-s. 

jr\um badsefe(O) 


Display a -(Viendly 
message febafe -feclis fehe^ 
bosfe wbafe bo do. 

Be su\re feo PAC^ youv ^ 
widgefes. 


lab — LabeKapp, feexfe—Wbe* you av-e rcady, dlidk o* febe bufefeonsf'; beijbfe — 3) 
lab.padkO 


Creafee fewo 
labeis feo bold 
eadb dounfeev- / 
a*d doymedfe febe 
labeis feo febe v 
'relevari Infel/av-s. 


labi =■ LabeKapp, fee*fevaviable =■ hum_jood) 
lablpadk(side — le-PfeO 


labZ =■ LabeKapp, fee*fevav-iable =• r\ur*__bad) 


labZpadk(side — VigbfeO 


bl — Bufe-Wapp, fee%fe — “Covredfef \ v/idfeb — 10, dommand — play__do\r\redfe_sour\d) 

Swtw id^ lj, .-.? a . tlc(s ! d . e .= M*'?. . .? ad *. !?> ? ad Y . . 1 91 . 

dormedfe feberw feo 

febeiv- v-elevanfe . 

evenfe bay\dlev. b2. — Bufefeor\(app ; fee*fe — l Wron<j/ w , v/idfeb =• IO, C,ommdv\d ~ play^v/V-OKC^souttd) 

bZpadk(side =■ Vicjbfe 1 , pad% =• IO, pady — IO) 

Sfearfe 

tkihteir s maih 
evenfe loop. 

affWmloojO 
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test drive 



With your newly amended code entered into IDLE, press F5 to see and 
hear the GUI in all its glory: 


Swcct... -fche -fully wovkihg 6\\A\. 



Thev-e i*t >s: \*osi s 

TV smile! 



0»c -Pihal decision' who ave you 
9 oih 9 ■(» iake with y ou ? 
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Your Prograwwiwg Toolbox 

You've got Chapter 7 under your 
belt. Let's look back at what 
you've learned in this chapter: 


* Wsw^ 3 ™ Y 
V'^ a 

* P\a?^ ^ 3 SW d ^ 

* e—tw-r»' 

, t od« 

* e*«t«a** 

„wU «er ^>“ 

( \ 0 oY*r'' tt ' 0 p tceW^ 

* *** - *— 


Python Tools 


* PW-e - a py-o-fessiohal-level set o( 
9 aw,ih 9 lib(r3H « that suppov-t sound 

* pa« - a pie* of *de that does »<>tU 9 

* bireak - exit &<,*. a | 00f) 

* tti »i*r - a stahdavd libv-av-y 4»- 

c*tal m 9 6}Uls Y 

■* TkO - a bla»k ^U| app 

* ButW) - a tkmter butto» wid 9 et 

* LabelO - a tki»teir labet widget 

f - a tkmteir integer vaviable 

that tam update the 6jUI "as i-f by r»a 9 ic" 


you are here ► 


255 




8 gms and data 



# Data entry widgets 




GUls don’t just process events. They also handle data. 

Almost all GUI applications need to read user data, and choosing the right widgets can 
change your interface from data entry hell to user heaven. Widgets can accept plain 
text, or just present a menu of options. There are lots of different widgets out there, which 
means there are lots of choices, too. And, of course, making the right choice can make all 
the difference. It’s time to take your GUI program to the next level. 


this is a new chapter 
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special delivery 


Head-Ex weeds a wcw delivery system 

Head-Ex Deliveries is a small delivery company that’s looking to expand. 
They know that delivery companies rely on their computer Systems, so they 
want to have a whole new system to book deliveries around the country. 



The system needs to be simple to use, so they want to use a graphical user 
interface (GUI). They want to give you the job of creating the system and 
even have a sweetener to make it worth your while. 


ttead-fc* e"?W ee 



bonus 


I 


DUT 


you 


on 


a 


The 


dei 


more 

more 


iver 


we 


the 


paid! 


get 


you 
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guis and data 


They've already desigwed the mterface 

Head-Ex has been thinking about expanding their business for a 
while and they already have a design for the interface to the new 
delivery system. This is what it needs to look like: 


3 


Theve ave a Wh 

ot data-er>tv-y 
•Cields- 



This is wheve the 
delivery details 
need to be savcd 


So how will it work? It’s pretty simple, actually. The user enters the 
details for a new delivery, including the description of the contents, 
the address it’s heading to, and the name of the Head-Ex depot it 
will be dispatched from. When the user clicks the Save button, the 
details are saved into a file called deliveries.txt. 



deliveries.txt 







What’s the difference between this GUI and the ones you created before? 
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text entry 


Read data frow the ftUI 

Think about the GUIs youVe created so far. Those apps ran code in response 
to events generated by users clicking buttons. So what’s different here? Well, in 
addition to generating events, your users will also be creating data. 

You need to do two things: 



You need to create an interface with places to enter text. 

The Head-Ex design shows exactly what the interface will need to look 
like: 



i 


© You need some way of accessing that Information. 

The data will need to be stored away in a file, so you need some way of 
asking the interface what text has been entered. That way, when 
someone clicks on the Save button, you’11 be able to write the data to 
the deliveries . txt file, like this: 


Yow 'Will need to APPEND this 
informatio» to the -file whenever ^ 

someone presses w £ave- w 

The format of the f >le 
does»’t matter, as W 5 as 
the de?ot staff ta« read «t- 


Depot: 
Seattle, WA 
Descriptiori: 
Books 
Address: 

1 Main Street 

Anytown 

WA 
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guis and data 


The Ewtrv and Text widgets let you enter 
text data into your GUI 

If you look at the interface design, youTl see that there are two different types 
of text field you will need to handle: short text and longer, multi-line text 
fields. To deal with these two needs, Pythoffs tkinter library has two different 
widgets for each data-entry type: 


A TfcXT FI&LP «s a 
tr bo* 0 « tbe sdxeer» tfcat 7°* 
tau use -to e»"tev- 


Entry widget: for entering single lines of text 


The Entry widget is what youTl use for most of the text fields. You can 
create an Entry widget like this: 


my_small_field = Entry(app) 

R e «.en>bev tbat 7 W , ,, 

al^s need. b> i"V°p tv>e 

tkmW librae 


One sihgle line ot lext 



starbuzzceo@gmail, com 


Text widget: for longer, multi-line text 


Because not all text data fits on a single line, tkinter has the Text widget. 
Think of email messages, Wikipedia pages, and word processing documents. 
For large multi-line data, you need something other than Entry. You need 
Text: 


/Wul-feiple lines o-f ie%i 

\L 


fjrf 


my_large_field = Text (app) 


You da* enier lav-ge pedes <A 
te*tual data in beve- 


// 




Castellor I mean. the fellow 1 b narae, Abbott; Who. 
Costello; The gtiy on first, Abbott; Wh-o, Costel- 
lo: The Abbott; Who, CostiUo: Th* 

guy playing.-, Abbott; Jtho is on firstt Costello: 
I'm. asking YOU who'B on first, Abbott; That^s the. 
manta name. Costello: That 1 3 who 1 a name? Abbott: 
Yes, Costello; Wall go ahead and teli me, Abbott: 
That's it, CoEtelio: Thafs who? Abbott; Yes, 


7T 


J JJ 


The Entry and Text fields should be enough to create the Head-Ex 
interface. But it’s not enough to simply create the interface. You also need to 
control the data inside it. 


% r**» 

p^V-or, is <* * 
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control text fields 


Read and write data to text fields 

When someone enters text into an Entry widget, Python Stores that text 
somewhere in memory as a stving. If you want to read the string, simply call 
the widget’s get () method: 


my_entry_field.get() 

t „ 

This will vetunn 'the stving • te trtdm. ■ 





ice crearo 


X I 


//y y /// y yj >y >y 


— 


■ ■ ■ 




But what if you want to change the contents of the widget, can you do that 
too? Yes, you can: add text to the widget using the insert () method. It’s a 
little more involved than just reading the text, because you need to say where 
you want the text inserted: 


my_entry_field.insert(0, "banana ") 

TtoTis the IHP£)< 

-tViC insertio* \>omt- 


.//'iy/vi/jl//y|y//»L L J 
Y/j f A/f / /fS 


-r 


- 4 — 


banana ice crearo 


01 ii&h' 


■■: ■: 


7T/ 




Uhr-i -f ields a« indexed Srom 0. 


You need to specify the index of the insertion point. Indexes in Entry fields 
work just like indexes in strings: they begin at gero. So if you insert text at index 
0 , the new text will appear at the front of all the text already in the field. In the 
same way, the delete () method lets you remove text from the field. You 

might want to delete the entire contents of the field, so tkinter gives you a | jf- m ehav-afctcv- 

handy END Symbol that lets you delete all the text like this: • -field is 




1 


0 is -the index. °f the tivst 

This will delete the entine dontents. tharatter » the tield- 

^ \r 

my_entry_field. delete (0 , END) 

>T 

BhlD is a spe£ial value 
that \rep\resents the last 
£ha\ra£te\r i* the -field. 


mdexed by 6NP- 


<A/J 


6 v/ 


f y y/y/y!/ 




ff r fi\ - <• ■ t -'<4 


y 

/ 


All the text has 0ohe> 


. Poofl 

/ \ \ 



The get (), insert (), and delete () methods give you complete 
control over the contents of j your Entry field. 

But what about Text fields? 
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guis and data 


Large text fields are harder to handle 


So Text fields should work the same way, right? Well, actually, they don’t. 
The designers of tkinter figured people might want to access particular lines 
and columns in Text fields. This means that while Entry fields use a single 
number to index the contents of the field, Text fields use a string, in the form 

row. column: 


Wnlik e BnbryO f ie | ds , 

Mhtjust 9 ei() io 

9« the eirtive tonienis. 


This mea^s W the fW- 

a«a COLUMBO, «the 

fw-st thavattev 'm the bt\i- 


This torst ehatraitcr has i*dex "l.o" 
Rov/ I- 



< 


my_large_field.get |'T.0 M 

r 

This viiU veW« the entive 
tc.aev.ts ot the tield- 


ats3. X o r 3 it,*A n the fellov 1 m namo. Abbott: WTio 

Cu s: tu 11 d : Tbu guy an first. Abbott: Hhb. C*at.o-1— 
lo: The first baa&nvar.. Abbott: Who. Costellor The 
END) i^jfuy playin-g. . . Abbott: Wbo ijs on firat 1 Co-stiillo: 

Ia» saking YOU nho'& on first. Abbott i That'a the 
“This wi|| B»n“s name . Costello; Thafs who‘s ne?ne? Abbott: 

^ Y *:■:: . Cos-tollo: WolL go .ubuzid and toll w , Abbott: 


^he Text -field. 


That 1 s it. CoBtello: That p s nho? Abbott: Yes 


2 


t 


Columi o. 


Once you understand how Text indexes work, youTl see that you can insert 
and delete text from them in a very similar way to Entry fields: 


my_large_field. delete ("1.0", END) 

This wil! dlca\r the -field- 


my_large_f ield. insert ("1.0", 


TO, «i» -«AJH Y al 

4-V>e stavt of the \ «eld- 



"Some text") 


Now that you know how to create text fields and 
control the text they contain, you're ready to 
build the Head-Ex application. 


§n 

Watch it! 


Be careful how 
you number 
rows and 
columns in 
Texto fields. 


Rows begin at 1, but columns 
begin at 0. 
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create the interface 



Code Magnets 


Complete the code to create the interface. Think carefully about the 
widgets you will need for each of the fields. 


from tkinter import * 


V«* do»’i need 
r° ^ ee P iraek of 

Ue bbel*, so ho 
H cA & a«i 9 , 
we»*. io vamiables. 


Oeate tbe ^W|. 


app = Tk() 
app.title('Head-Ex Deliveries') 


_ R,«ll ttal 

—. r./Uets to tbe >Nmdo>M- 
Label (app, text = "Depot:") .pack() *tnC 


depot = Entry (app)^^,! ^ ^ ^ ^ 
depot. pack () o-P tbe data errbry -Pidds, so 


assi^h tbem to va\riablcs. 


Call*m$ w p a ^0 w v/itbout oftions 
r*ea*s you Icavc it to tkmtev- 
to &t£\&t bow best to lay 
tbings out oy\ tbc £)U|. 


Button(app, text 


"Save", command 


TViis w>ea«s -tbe tabb>« 

save_data) .pack () . ( |j ta || save^dataO 

•fundton wben it s dlitked- 
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guis and data 



In addition to the GUI code, you need to write the function that 
will save the data from the GUI to the deliveries . txt file. 


The Save button on the interface is going to call a function called save_data () .The function will 
append the data from the GUI to the end of the deliveries . txt file formatted like this: 


Depot: 
Seattle, WA 
Description: 
Books 
Address: 

1 Main Street 
Anytown 
WA 


_ 


Then it will need to ciear the fields on the form to make them ready for the next record to be entered. 
The function will have to appear in the program before the GUI code. Write the code for the function 

Po7t Wfc * fiRf 

need s t» tV>e data- 

TttfcH *>eeds b> tleav . 

-the -f ields- 
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interface created 



Coae Magnets Solution 

You were to complete the code to create the interface. You were to 
think carefully about the widgets you will need for each of the fields. 


sdve drtiO" 


The 

from tkinter import * ■. *•£ * t. 




app = Tk() 

app.title('Head-Ex Deliveries’) 
Labe1 (app, text = "Depotpack () 
depot = Entry(app) 
depot.pack() 


*e it 
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guis and data 


r fciharpen your pencil 
^ V Solutiori 


The Save button on the interface is going to call a function called 
save_data () .The function will append the data from the GUI 
to the end of the deliveries . txt file formatted like this: 


Depot: 
Seattle, WA 
Descriptiori: 
Books 
Address: 

1 Main Street 

Anytown 

WA 


Then it will need to ciear the fields on the form ready for the next record to be entered. The function will 
have to appear in the program before the GUI code. You were to write the code for the function here: 


'/ouv toAe. may look a 
litti e di-ffevent- 


det save dataO: 


^end the te*t to the end ot the -file, 
\ust as you did when we wv-ote the POS 
Pv-o<y-ams tov the Health Club. 

.i. 

tileD — open( u delive\ries.t^t ;; , l V0 

v to «w . i * 1 c D . t c tT ) . c ?. o t : ir? . 

*£* a * Uhri ~z7.^ e P.:^ e ^y.. 7 ° 

ti I e D • v/\ri t e ( U D esdiri p ti on : \n ;; ) 

'fileD >/vite^ u 7os\n w % desdription<jetO) 

Vf' °}^ NP) tileD.wit e ( tt /\ddvess: V) 

vetuv-ns tne . . . . —. 

*>"te»ts <£ a Te*t r.lep.^ite( u %s\,” % addresStH.0", EKD)) 
f.eld- .;. 3 . 

depotdelete(0, END) 


IW-t io ilea*- A- 
Je -fields a-fie*- savi»a 
the data. ••• 


des£\riptiondelete(0, END) 


addv-ess.ddcteCTO^ END) 


This means w lst row, Oth dolumn- Remembef 
that vows stavt at I and dolumns tvom 0 . 
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test drive 



Tqst DriVq 


The deliveries program is ready, so it is time for the demo. With the code 
entered into IDLE, press F5 to fire it up and you should see this: 



brnltlr. ViA 

Iteti rurimv 

/udrir-pt-c. 



V^lr $UI j s 
iooking good. 


1 Wain Sire&t 
fyijr Lavr 



You can enter data into each of the fields, even the multi- 
line address. When you click Save, the fields all get cleared. 
When you open up the deliveries.txt file, you see that 
the data you entered into the GUI has been saved. 


Depot: 
Seattle, WA 
Description: 
Books 
Address: 

1 Main Street 
Anytown 


Congratulations! YoiTve written your 
first GUI data-entry applicatiori. 
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guis and data 



BULLET 


POINIS 


■ Entry fields are used for single lines 
of text. 


Remove text with the delete () 
method. 


■ Text fields are used to handle multi- 
line text. 

■ Read the contents of fields with the 
get () method. 

■ Add text using the insert () method. 


Entry fields are indexed with a 
number starting atO. 

Text fields are indexed with a string, 
starting at "1.0". 


-tJiereigre no 

Dumb Questibus 


Is it possible to put more than one line of text into an 
Entry box widget? 


Yes, you probably could, but if you need to do this, you are 
much better off using a Text box, because they are designed to 
handle more than one line of text. 


NL- I notice that we are calling the pack() method as partof 
the label creation code, whereas before we assigned the label 
to a variable then called pack() on the new variable. Which 
packing technique should I use and does it really matter? 

No, it does not really matter which technique you use to call 
pack (). If it makes sense to pack your widgets as they are 
created, include the call to pack () as partof the creation code. 
If it doesn't make sense, assign the widget to a variable and do 
your packing whenever you need to. If you look at other examples 
of tkinter code on the Web, youll see that other programmers use 
both techniques. 


Why can't we just assign a value to an Entry box using 
the assignment operator (=)? Why do we have to use the 
inserto method? 


The Entry box is a widgetobject, nota Python variable, 
so using the assignment operator does not make sense here. 
When working with objects, you need to use the application 
programming interface (API) provided by and included with the 
object, which in this case is the insert () method. 


Qj Why do the rows in a Text box start counting from one 
as opposed to zero (like everything else in Python)? 

Beats the hell out of us. No idea. 

Qj So, justto be ciear, Who is on first? 

No. Who is on second. Python is on first. 
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the other cambridge 


Owe of the Head-Ex deliveries wewt astray 


For the first few days, the System worked great. Deliveries were correctly 
booked and goods were shipped. But then, something odd happened at the 
British delivery depot. 



I'm terribly sorry, old chap, 
but I think these boxes 
were meant for the other 
Cambridge. Cup of tea? 


One of the deliveries went seriously astray. A consignment of college 
football jerseys was sent to Cambridge in England , instead of the Cambridge 
in Massachusetts. But the System is stili working fine, isn’t it? So what could 
possibly have gone wrong? 


There's no time for tea. Let's get to the bottom of this. 

Dut rt \«as lovtly 

■t® be asked... 
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guis and data 


Users can enter anythinq in the fields 

The system is doing exactly what it was designed to do: it lets people enter 
the details for depots, descriptions, and addresses. The trouble is, even though 
there are only a few depots, the Entry text fields lets the user type pretty 
much anything. There are no Controls on what gets entered into the GUI. 



This is MlB l<$U0U£. Ii 
is no-fc -fco-tally ciear whieh 
Ca*v>bvidge is mean-fc. 


It wasn’t obvious whether the delivery was intended for the Head-Ex depot 
in Gambridge, MA, or the Head-Ex depot in Gambridge, England. You need 
some way to prevent users from entering ambiguous data in the depot field. 





Think about the GUls you’ve used in the past. How could you 
restrict the values that someone could enter into a GUI? 
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radio buttons 


Radio buttons force uscrs to choose a 
valid depot 

Text fields arefft the only data-entry game in town. If you look at any 
GUI program, you will find a whole host of different widgets being used: 
sliders, buttons, check boxes. Why are there so many different types of 
widget? Are they just there to make the interface more interesting to use? 

The reason there are so many widgets is to allow the programmer to 
efficiently manage and control the kind of data that people can enter. 


Clitk AM a*d the FM 1 butto 

■ 4 ( 





b 

/ ; 


( 1 

11 

[ 

/ / 

/ 

j 

/■ 


• ? " • 'f 




If you want to allow a small number of values for a field, you can 
use the radio button widget. A radio button works just like the AM/FM 
selection buttons on your radio: press AM and the FM button pops up. 
Press FM and the reverse happens. 

Radio buttons in a GUI program work in the same way: if you select 
one of the buttons, the other buttons are automatically deselected. That 
way, you can choose only one from a small group of options. 


Rad.o WtW 



<s> Cambndae, mft 

O Cambr \dne, uva 
O Sea-t-tte, uoft 


Cliek FM and 'the button POPS 

\ 






So if you replace the depot Entry field in the Head-Ex 
program with a set of radio buttons, you prevent users from 
entering ambiguous depot names. That way, they will be able 
to choose one, and only one , depot. 
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guis and data 


Creating radio buttons in tkintcr 

You need to create three radio buttons in the interface, one for each of the 
depots. This is how you might do that in tkinter: 


U dor! i »ttd tV>e 
'rir-j U\d ^rrort- 


Radiobutton(app, text = "Cambridge, MA n ).pack() 
Radiobutton(app, text = "Cambridge, UK”).pack() 
Radiobutton(app, text = "Seattle, WA").pack() 

Label(app, text = "Description:") .pack () 


' S ‘the -tex-t 
■fcta-fc wi II appear 

yb &>e (radio 

buttoh. 


You need to remove the depot Entry widget and replace it with three 
Radiobutton widgets, one for each of the valid depots. The text given to 
each widget will be the text that appears alongside the radio button in the 
interface. 

What about reading which radio button has been selected? For now, you just 
need to create a prototype of the interface, so there’s no need to change any 
of the code that saves records. That’s something we can deal with later. 

Let's demo the new interface to the guys at Head-Ex. 
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test drive 



'esT DriI/q 


It 5 s time for the demo of the new version of the interface. When the guys 
from Head-Ex arrive, you fire up the new program in IDLE: 



There’s clearly something wrong with the prototype. There is only 
supposed to be one radio button selected at any one time, and yet the 
program shows all of the radio buttons selected together. 

What happened? You need to look in a little more 
detail at how radio buttons actually work. 
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The radio buttons should work together 

When you modified the code, you added the three radio buttons like this: 


Radiobutton(app, text 
Radiobutton(app, text 
Radiobutton(app, text 


"Cambridge, MA").pack() 
"Cambridge, UK").pack() 
"Seattle, WA").pack() 


That code added three new radio buttons to the interface, but it created 
them as three independent widgets. This means that each of the radio buttons is 
working separately, with no knowledge of the other two. 



Cambridge, 
0 Cambridge, 


MA 

UK 



0 Seattle, WA 


But the whole point of radio buttons is that they work together. 
When you select one radio button, you expect all of the other radio 
buttons to be deselected, just like the buttons on the radio. 

GUI programs often need to synchronize different widgets 
together. You do something to one widget, which results in 
something else happening to another widget. 

So how might you get your radio buttons to 
cooperate? 



Me» Re AM buiR» is 

selefcted, Re FM bu-tR» 
should be deseletted- 







Think about the way you want radio buttons to work. Is there something 
that they all need to share? What is it? 


you are here ► 


275 



















model update 


The radio buttons caw share a model 


The text fields you originally created each stored a single data item. For every 
widget on the screen, there was a single piece of data. But that’s not true 
for your radio buttons. The three radio buttons will be used by the user to 
record just one thing: the depot that a delivery is sent to. The three radio 
buttons needs to share a single piece of data. And that piece of data is called the 
model. 


O 

o 



This is -the model 
Widden avMay 'f»# 

£.om?utev's n>emO*-'/ 


Q) Cairibridge, MA 



to 



(0 CambPidge, UK 


O 


t 


Seattle, WA 


So if the Seatt le radio button is selected, it will update the model with 

a new value. 

You haven’t set values on the radio buttons yet; you Ve only set text 
descriptions. You could set the values to be whatever you want, but it is 
simplest to set them to the same thing used as the description of the field: 


The text is the desemiptioh 
that appeams ok the sevee*. x 

RadioButton (app, text 


This VAL-WE is the or\C that 
Will he used in the model 

vT 

"Cambridge, MA", value = "Cambridge, MA") 

y ou da* male the te*t di-fferent 
tvom the value, but let s leavc 
them the sa^e hev^e- 


So what happens afterthe model is updated? 
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The systcw telis the other widgets when 
the model changes 


The tkinter library code will keep a track of which widgets are using which 
models and, whenever a model changes, tkinter will let the widgets know 
about it. So if we select the Seatt le, WA radio button, it will update 
the model, and the other radio buttons that share the model will deselect 
themselves. 




Cambridge, MA° 



t») Seattle, WA 




There’s a special name for the way this code works: 



\ 


/ 






The model is the data stored. 


View Controller 


v 


\ 


The view is just a fancy name for the widget. 


And the controller is the code in tkinter that lets all of the views know 
when the model has changed. 


So much for the MVC theory. Time to fix the code. 
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tkinter models 


$o how do you use models in tkinter? 


Imagine you wanted to add delivery options to the program. You could use 
radio buttons and do something like this: 

uT 


IVs bo £><PL|C|TLV 

eatb butbo* a \/ALU£. 


Radiobutton(app, text = "First Class", value = "First Class").pack() 

Radiobutton(app, text = "Next Business Day", value = "Next Business Day").pack() 


You then need to create a model for the radio buttons to share. In tkinter, 
models are called control variables, and control variables that store text 
are called St rinqVars: , ,, , , x/ r 

A Stridar «s >st Wkt tbe IntVar W 
k--' Chapter 7, e*dept that it holds a sbrin$ 

Service = StringVar () ^ ^ ^ ^ ^ spedia | va | ue 

Service, set (None)^-"None" means "No value." 

Radiobutton(app, text = "First Class", value = "First Class", 

variable = Service) .pack() 

Radiobutton(app, text = "Next Business Day", value = "Next Business Day", 

variable = Service) .pack() 


This code will now give us a pair of buttons that work together. If you 
select one, the other will automatically become deselected: 


^ km . '©FirstClass 

Clitk the SECOND of>tion and V 

-the FIRST will be deselettedJiwt _ _ 

XJf Next Business Day 


And if you ever need to read or change the model value in the code, you just 
need to call the StringVar's get () or set () methods: 

This vetuvns the turrent 
value of the model- 

"Next Business Day" 


»> print (Service. get () ) 


>>> 


Service.set("First Class") 



tjJ First Class 
'© Next Business Day 
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Poo] puzzjc 


This is the section of the program that 
creates the depot radio buttons. See 
if you can complete it using the 
fragments of code from the pool. 
Be warned: you might not need 
all of the pieces... 


Label(app, text 


_ M 


Depot:") •pack () 


depot.set(None) 

Radiobutton(app, . ,. ,. ).pack() 

Radiobutton(app, .,. ,. ).pack() 

Radiobutton(app, ., , ).pack() 


Note: each thing from 
the pool can be used 
only once! 



fc^Sharpen your pencil 


What piece of code would you use to make sure all of the radio 
buttons are cleared affer the record is saved? 
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depot buttons 



P®®1 Puzz]6 

This is the section of the program that 
creates the depot radio buttons. 

You were asked to see if you could 
complete it using the fragments of 
code from the pool. Not all of the 
pieces were needed. 


Label (app, text = "Depot:") ,pack() 

depot = StringVar() 


depot.set(None) 
Radiobutton(app, 
Radiobutton(app, 
Radiobutton(app. 


variable = depot, 
variable = depot, 
variable = depot. 


text = "Cambridge, MA", value = "Cambridge, MA").pack() 
text = "Cambridge, UK", value = "Cambridge, UK").pack() 
text = "Seattle, WA", value = "Seattle, WA").pack() 


Note: each thing from 
the pool can be used 
only once! 




Y\ov\t o£ *tke v-adio — 
kutbcms kavc -tWis value, Y\OY\t 
't-kew' v/ill ke sele^ted- 


What piece of code would you use to make sure all of the radio 
buttons are cleared after the record is saved? 

* defo*t.se*t(Nor\e) 
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guis and data 



Now it’s time for another demo of your program. When you first fire up the 
program, you see that there are initially no depots selected. 



That’s good. Now what happens if you select the first option, then change to 
the third? 







H»ad-EK DelLvertot 


Ufcpot; 

h ni bndg p, MA 

cambridge, u*c 

i WA 



H&ad-Ex Dalivartae 


Uepot: 

Cambrid-ge, MA 
Cannbridgc. UK 
* 5*dLlltf„WA 
Descriptiori; 

Addm^b: 


|-f you selefrt "Seattle, 
m, you auWa-tifcally 
deselet-t U Caw»b\rid5C) 

M#’- 



If you make a selection, the other radio buttons automatically deselect 
themselves, which is exactly what you need. 


The radio buttons are working correctly. 



Phew. Now the users will 
always send the packages 
to real depots. You did a 
great job. Thanks! 
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many more depots 


Head-Ex'$ business is expanding 

With the new Systems in place, business is better than ever at Head-Ex. They 
have new trucks, more employees, and an increasing number of offices. 



But with this success comes a new problem... 
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There are too wawy depots ow the (rUI 

The coders at Head-Ex have been amending your program to add new 
depots as they were opened. But there’s a problem. Now there are so many 
depots that they can’t all fit on the screen. 


Head-Ex Deliveries 


Depot: 

<* tambridge r MA 
1 Cambriclge r UK 
■>' Seattle r WA 
'■*' New York r NY 
i Dalla& r TX 
Boston r MA 
'•* Rome r Italy 
■>' Male r Maldives 
Luxor r Egypt 
■>' Rhodes r Greece 
Edinburghr Scotland 
Deseri ption: 




Address: 



Something needs to be done to the GUI. But what? 



VAkN 




What kind of widget would you use instead of a radio button to fix this? 
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multiple options 


An OptionMenu lets you have as wany 
options as needed 

An OptionMenu or drop-down listbox is a widget that lets you restrict the 
number of options a user can choose, just like a group of radio buttons. But 
it has a couple of important differences. 

First, it takes up a lot less space than a functionally equivalent group of radio 
buttons, about the same amount of space as an Entry text field. Second— 
and this is the really important characteristic—when you click it, an option 
menu can display a large list of options. 



;C_agi bfid g& > MA 
iCair.brldj?^, UK 
Seattls, V/A 
New York, NY 
D alias, TX 
Boston,, MA 
■jftQime, Ttaly 
Male, MaldEves 
LUXOP, Egypt 
Rftodes* Greece 
Edtnburgh p BcotJand 





F 3 


I 





The useir eould 
seled-t a depo-fc -(Vor* 
°p“fe>oK» mehu. 


If the Head-Ex coders use an option menu, they will be able to increase 
the number of depots available, but they won’t have to increase the size or 
complexity of their GUI. 

So what needs to be changed in the code if you want to swap the radio 
buttons for an option menu? 

It's not what changes, but what stays the same. 
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guis and data 


The jwodel stays the same 

Think for a moment about the model you are using with the radio buttons. 
It represents the name of the chosen depot, which you want to keep for the 
option menu. If the model stays the same, then your code, which currently 
looks like this: 


depot = StringVar() 
depot.set (None) 


Radiobutton(app. 

variable 

= depot. 

text = 

"Cambridge, MA", 

value 

Radiobutton(app. 

variable 

= depot. 

text = 

"Cambridge, UK", 

value 

Radiobutton(app. 

variable 

= depot. 

text = 

"Seattle, WA", 

value 


_ M 


_ 11 


Cambridge, MA").pack() 
Cambridge, UK").pack() 
Seattle, WA"),pack() 

can be replaced with code like this: 

depot = StringVar() 
depot.set(None) 

OptionMenu(app, depot, "Cambridge, MA", "Cambridge, UK", "Seattle, WA").pack() 


The setond yarameter 

be the «odei and it dee» t 
need the “vaviable - 


* 

A list ot all the options that 
appean in the widjet 


<R_ 


rhis is the sa«e 
"'odei as be-fove. 


Put wait... you don't have to list aH the values like that 

It looks like a lot of work to put all of the options in the actual function call to 
OptionMenu (), doesn’t it? After all, there’s a large list of depots. 

Thankfully, Python comes to the rescue. If you have the options already 
stored in a list: 



CaTn bndg g;, M A 


i CimbriUK 
ISeattls, WA 
New York, NY 
Dahas, TX 
'Boston,, MA 
‘Romc, Italy 
Male, MaldLves 
Luxor, Egypt 
Rho des» Grecce 
Edinburgh, BcotSand 



3 


depots = ["Cambridge, MA", "Cambridge, UK", "Seattle, WA"] 


you can pass the entire list instead of separate values like this: 



OptionMenu(app, depot, *depots) .pack () 


TW,s * «eans "Take -the vestof 

the pava«ete<rs (rem th.s l«t 
and insev-t the» heve- 


Now let's put the pieces together. 
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adding options 



fjo m£ EmciSe 


This is a version of the program that uses radio buttons. 

You are going to update this program so that it uses an option menu. But the options need to be read 
from a text file. 


from tkinter import * 


def save_data(): 

fileD = openCdeliveries.txt", "a") 
fileD.write("Depot:\n") 
fileD.write("%s\n" % depot.get()) 
fileD . write ( "Descriptiori: \n" ) 



app.title('Head-Ex Deliveries') 
Label(app, text = "Depotpack () 



description.pack() 

Label(app, text = "Address:") .pack () 
address = Text(app) 
address.pack() 

Button (app, text = "Save", command = save_data) .pack() 
app.mainloop() 
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guis and data 



First, you need to create a function called read_depots o thatwill read the lines in a textfile and return them to 
yourcode as a list. 


Hint: When you read a line from the file, it might have a newline character at the end. The rstrip () string method 
will remove it for you. 



Then, you need to replace this section of the code with code that generates an option menu using the data from the 
O read_depots () function you just created. It should use a file called depots. txt. Write the code here: 


you are here ► 
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options added 



jfcoNg ExGRaSe 



This is a version ofthe program thatuses radio buttons. 


You needed to update this program so that it used an option menu. But the options 
were to be read from a textfile. 


from tkinter import * 


def save_data(): 

fileD = open("deliveries.txt", "a") 
fileD.write("Depot:\n") 
fileD.write("%s\n" % depot.get()) 
fileD . write ( "Descriptiori: \n") 



app.title('Head-Ex Deliveries') 
Label (app, text = "Depot:") .pack() 
depot = StringVar() 



descriptiori. pack () 

Label (app, text = "Address:") .pack () 
address = Text(app) 
address.pack() 

Button(app, text = "Save", command = save_data),pack() 
app.mainloop() 
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guis and data 


^ First, you needed to create a function called read_depots o to read the lines in a textfile and return them as a list. 



RetiAV-n the l' s t 
the ea!U$ toA e- 


Then, you needed to replace this section of the code with code thatgenerated an option menu using the data returned 
O by the read_depots o function. It needed to use a file called depots.txt. You were to write the code here: 

Call the -Puhdtioh; passive} i» the 

pame of the -Pile to \read the data . 

^' ro,rv '’ V—^ optior\s =■ read_depots( u depotst*t”) 

Use tiie data to W.ld tV>e ^ 

o^t»ov\ 
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test drive 



0ST Driiiq 


Before you run your program, be sure to create the depot s . txt file. When 
you start up the program in IDLE, the interface is a lot more compact and 
even easier to use: 




n \tt and neat W 

depot options 


Depot: 

Cambridqe r MA 



cambrldge, r4A 
Cambridge, UK 
Seattie. WA 
New Vorkp NY 
DaFlas P JX 
Boston P MA 
Romep Italy 
Malo, Maldives 
LuxlHp EyypL 
Rhodes, Greece 
Edinburgh, Scotland 


The system is working really well now. And, due to the depots being stored in 
a file, Head-Ex can change the list of depots in the file without having to amend 
the code in any way. 


Your GUI program builds the list of depots dynamically 
and on-demand, which makes it very flexible indeed. 
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guis and data 


Things are going great at Head-Ex 

The GUI system is easy to use, and by restricting the depots with an option 
menu, the quality of the entered data is spot on. This means the Head-Ex 
delivery Service is more reliable, the number of customers is increasing, and 
the business is growing bigger—worldwide. 



CKetk <wt rtead-T-^s 


Using tkinter's data models, you used the power of 
model-view-controller to build a GUI data-entry system 
that really rocks. 


you are here ► 
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CHAPTER 8 


programming toolbox 



Your Programming Toolbox 

You've got Chapter 8 under your belt. 
Let's look back at what you've learned 
in this chapter: 


* MVC - Modc\. \r* 


Too\s 

M.dA i** ***" 

I ^ \nC>*S. 


o i- w-tW ^ ^ 

* Rad>° . . 

3 ^oa^\* 

iVitafeo»' 

• * ■ dw 


t)*ff sV>avc 


* 


Toois 

£*bry() _ 

! ” J " ^ fc ftt,. 

* Wo _ . " “ e '»e. 

rp™- ■ *“*«-. ‘ 

r oojr3"'"' e * A «a -f-iro^ <0. 

^,L ' 

hU »'d aboui d J ~, kee ^ibc 

* ^lA *.0 _ a ^ ^ 9 «- 

* h »w. u ?daic tui «* 

* Radio ^ *W; _ j.. 

X ° U io se l e£i o USe '* ul & tfca. 

^ 0U P m &i h ^. * he 6 ** a 
* ^'ow/WenuO _ f , 

/7*^ *° */«* US ^ ^ ^ 
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8 l /i exceptions anc[ message boxes 


X Get the message? 



Sometimes thingsjust go wrong. You just need to handle it. 

There will always be things beyond your control. Networks will fail. Files will disappear. 
Smart coders learn how to deal with those kinds of errors and make their programs 
recover gracefully. The best Software keeps the user informed about the bad things that 
happen and what should be done to recover. By learning how to use exceptions and 
message boxes, you can take your Software to the next level of reliability and quality. 


this is a new chapter 
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the cheese stands alone 


What'$ that swell? 

Just when it looked like things were going so well, there was 
a problem in the Head-Ex storeroom. 



A consignment of cheese 
never got recorded and 
ifs been going bad in the 
storeroom. WeVe had to 
issue gas masks... 


A trainee was recording the consignment of cheese when 
there was a problem that prevented the program from 
recording the delivery. That meant the cheese was never 
assigned to a delivery truck. So the cheese never left the 
storeroom and it just sat there for a very long time. And that 
meant—well, you can just imagine... 


To prevent the same thing happening again, 
you need to find what caused the problem. 
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exceptions and message boxes 


Someowe changed the file permissiows 

It turns out the whole thing was caused when someone from Technical Support 
decided to change the permissions on the deliveries . txt file, making it 
read-only. When the System tried to write deliveries into the file, it failed. But 
what’s worse, it failed silently: 



Bc£3use y\o evvov" 

message appeared 'm 
-the ^U|, -the -tramee 
-thihks every-thmg is 0^. 

v, 

"delivev-ies.-t^ 
was made vead- 
oy\ ly- 




Uepot: 

EiJinl.iu^li, SidEdricl 


UMcription^ 


Adld i «db-b. 


Hease! 
ITBSPnnrfts ^trp*t 
Ediiiburgh 
Scoti and 


deliveries.txt 



The ev-rov- m -the 
Python Shell was ^ 
no-t Ko-tifced by *the 
•bramee. 



£ilp Eriit r.hpjl M 

1'ytfton i r 1 # 1 i' iri 
JGCC 4_3*3| uu 1. 
Type " Copyright M j 
>» ====== 

>» 

»> 

Rxirhfiht i uii ■ ii ""V i 

L 

TraccUacK (meat i 
F ilff ■ /tjmt / Ihx: 

return b©I£. 

T i 1 tt " /h I Illi i'- 1 / i lr! 

tile - opar.^' 
TOFr r i n r ~ |Frtim 11 


When you were writing programs that ran in the Python Shell, 
you could always teli when it failed: a huge, ugly error message 
appeared. Why not with GUIs? Don’t they do the same? 

They do, but the trouble is that the message appears in the Shell 
and your user is busy looking at the nice GUI, so the ugly error 
can often be missed. 


When using a GUI, how do you spot errors? 
One e spotted, what happens then? 


Note:To reproduce this error on your PC, 
you need to make your deliveries . txt 
file read-only. How you do this depends 
upon your operating system. If you are 
unsure how to make a file read-only, check 
the Web for more advice (or ask a friendly 
local guru). On most Systems, it involves 
editing the properties of the file. 


you are here ► 
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making an exception 


When it cooldn't write to the file, 
the program threw an exception 

What happens when an error occurs? Some errors are really bad\ they cause 
the program to crash. Other, less serious errors are known as recoverable : the 
program can keep running, even though something went wrong. You can spot 
these situations in your code, because most programming technologies throw 
an exception when they occur. 

Imagine a line of code that has a problem, such as the line that was trying 
to write to the deliveries . txt file. Python will spot that the append 
operation failed and, instead of running the rest of the code that follows, 
Python abandons ship and skips out of the code completely. That’s what 
throwing an exception means: the program doesn’t crash , but it abandons what 
you were trying to do and tries to recover the situation: 


TVtis Ime 
o-f Lodt 
tduses 
e%£epti oy \ 

*bo be 
-tbv-owrr 



def save_data() : 

fileD = open("deliveries.txt", "a”) 

fileD.write("Depot:\n") 
fileD . write ( "%s\n" % depot.getO) 
fileD.write("Description:\n") 
fileD.write("%s\n" % description.get ()) 
fileD.write("Address:\n") 

fileD.write("%s\n" % address.get("1.0", END)) 
depot.set ( " " ) 

description.delete (0, END) 


description.delete(0, END) 
address.delete("1.0", END 


AH -fehis Code 
is skipped. 


But why skip past the rest of the code? Why not keep on running? Generally, 
that would be a bad idea. Once a line of code has gone bad , there’s no way of 
knowing if it makes sense to keep running the code that follows. For example, 
if the Head-Ex code can’t open the deliveries file to append to it, it makes no 
sense to continue trying to write data to the unopened file! 

In order to recover, you need to start running your code 
from somewhere else. 
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exceptions and message boxes 


Catch the exception 


Python spots when an exception is thrown , and you can write some code to 
run when the exception occurs. This is called catching the exception. The code 
that you run when there’s an error resulting in the thrown exception is called 

an exception handler. 


/ 


\ J ' 

Bang! 


i \ \ 


def save_data() : 

fileD = open("deliveries.txt", "a") 

fileD.write("Depot:\n") 
fileD.write("%s\n" % depot. get () ) 
fileD.write("Description:\n" ) 
fileD.write("%s\n" % description.get()) 
fileD.write("Address:\n" ) 

fileD.write("%s\n" % address.get("1.0", END)) 
depot.set("") 

description.delete(0, END) 
description.delete(0, END) 
address.delete("1.0 ", END) 



Ereptio* 

hdhdlihg 

£ode. 


Greating exception handlers can really make life easy for your users. Instead 
of a flaky program that crashes or fails silently the first time something weird 
happens, you can write programs that gracefully recoverfrom errors. Exception 
handlers tidy up when something goes wrong and can even let your user 
know that something strange happened. 

That’s what you need here: an exception handler that telis the user when 
there’s a problem writing a delivery to the file. 

How are exception handlers written in Python? 


A piece ol code 
that runs when 
an exception is 
thrown is called an 
exception handler. 


you are here ► 
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try to except 


Watch for exceptiows with try/except 

In order to recover from an error as it happens, you need to indicate the code 
that might throw an exception. In Python, you do this with try and except. 

All you need to do is take the piece of potentially troublesome code and add 
the try and except labeis: 



If an exception is thrown between the try and except labeis, the code 
that follows the except label runs. The code that threw the exception 
is abandoned. If no exception occurs, the code runs normally and the 
code that comes after the except label is ignored. 

Notice that the try/except labeis are wrapped around all of the 
function’s code. If there’s a problem opening the deliveries . txt 
file, you don’t ever want to try writing to it. So, when trouble strikes, 
you should adandon ship and skip to the code that tries to recover from 
the error. 


The code that then runs is the exception handler. 
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exceptions and message boxes 


v 

i 


Exception Magnets 

Assemble the code to handle an exception in the save_data () 
function.The exception handler needs to display the details of the 
exception in the title bar of the window. Note: remember to indent 
the code in the exception handler, in addition to the code in the 
try block. 


fileD = open("deliveries.txt", "a") 

fileD.write("Depot:\n") 
fileD.write("%s\n" % depot.get()) 
fileD . write ( "Descriptiori: \n" ) 
fileD.write("%s\n" % description.get()) 
fileD.write("Address:\n") 

fileD.write("%s\n" % address.get("1.0", END)) 
depot.set ( "") 

description.delete(0, END) 
description.delete(0, END) 
address.delete("1.0", END) 



you are here ► 
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exception handler 



Exception Magnets Solution 

You were asked to assemble the code to handle an exception in the 
save_data () function.The exception handler needs to display 
the details of the exception in the title bar of the window. You 
needed to remember to indent the code in the exception handler, in 
addition to the code in the try block. 



fileD = open("deliveries.txt", "a") 

fileD.write("Depot:\n") 
fileD.write("%s\n" % depot.get()) 
fileD . write ( "Descriptiori: \n") 
fileD.write("%s\n" % description.get()) 
fileD.write("Address:\n") 

fileD.write("%s\n" % address.get("1.0", END)) 
depot.set ( "") 

description.delete(0, END) 
description.delete(0, END) 
address.delete("1.0", END) 


VfcVe W 

display tfce t+ttvbo» w vtt ■ 

ii 


This is the ttUyko* ^ 
handlev dode- 



T~Kc exdeption hahdlev dan have 
scveval lines as long as they ave 
^11 indented in the sar*e way. 
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exceptions and message boxes 



Let’s see if the code works. Make sure the deliveries . txt file is read- 
only. Then run the new version of the program in IDLE and try to record a 
delivery by clicking on the Save button. 

Ckkina w Savc J ' 
tduses •tbc 
-ti-blc bav- *to 
cha^c, duc *to 
*tbc cv-v-ov-. 




deliveries.txt 


Cimi writc to the filo [Errno 13] Pcrmbsion denicd: 'dclivcric5.txt" 


Utepot: 
DaHas,, TX 


De&cnption: 


Stmky Oiccsc 


Addrcss; 


itinka-R-Us 

47 Wha I Hjpnnij AvFmiH 

Dallas, i X 



Ko*tc : w»akc suve 
dclivcv-icst^t «s 
sc*t {p v-cad-only- 


Sure enough, when you try to save the delivery details, the program catches the 
exception and the exception handler displays the error message in the window 
title. 


Wonder what the people at Head-Ex will think of this? 


you are here ► 
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unexceptional exception handler 


There'$ an issoe with the exception handler 

You do a quick demo for the folks at Head-Ex and, even though the program 
works, it’s not quite what they need. 


I'm not sure the error 
message is really visible 
in the title bar. If there 
is an error, I really don't 
want to miss it. 


O 



The error message is more visible than when it was appearing in the Python 
Shell , but it isn’t a whole lot more visible. Sure, you Ve proved that you can 
spot when an error happens and then run an exception handler in order to 
do something about the error. But you really need to do something that will 
interrupt the user and highlight the situation. You need something that will 
force the user to acknowledge the error before he continues doing something 
else. 

A GUI message box might do the trick. 
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exceptions and message boxes 


A message box demawds attention 

Most of the time, GUI programs put the user in charge. If the user chooses 
to click a button or edit a field, the computer lets them do just that in 
whatever order and at whatever time the user chooses. But sometimes, GUI 
programs need to stop the user and ask her a question, getting her to conflrm 
or acknowledge something. That’s where message boxes come in. 

A message box is something that requires a response, which is why it’s 
sometimes called a dialog box. 

The simplest message box displays a message with a single OK button: 


Tbis idem shows 
it*s a warnmg. 




Vo or hovercra^t is $v)) eels! 4r 



T 


This is the message. 


The user must dlidk the w 0£ w kutto* 
to dcmtmue, 'mdidatmg that she 
adknowledges the message- 


A message box always displays the message in a separate window, typically 
in front of your main GUI window. And it won’t go away until you click 
it, dismissing it. That’s why message boxes are the most commonly used way 
of displaying errors. The user has to read and respond to the error before 
continuing. 

You should be sparing in how often you display message boxes, because if 
users see too many of them, they are likely to click them without reading the 
message. But, when used carefully, they keep your user informed and alert. 
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declarative and interrogative messages 


Creatmg message boxes m Python 

All of the message box code is contained within a tkinter module called 
messagebox, so the first thing to do is import the module: 

import tkinter.messagebox 

Then, you’re good to go. Within the messagebox module, there’s a whole 
bunch of different dialogs to choose from. But all of them fall into two main 
categories. 


Message boxes that say stuff 

To display a simple message on the screen, you might display a message box 

like this: _ . r 

I he dontents or the message. 

tkinter.messagebox.showinfo("Delivery", "The cupcakes have arrived in Istanbul") 


The title o-f the message bo% 


T 



oeliver^ 


The idon in •the window shows 
thai thi 


his is jusfc -fov 'vn(o>rn>ak>on ^T 
ow need to dlidk the 0\C j 


1 toe c-upcaKe^ ar i i\/ed in 

tetanbui 




/< 

bwttoin to dlose the dialofj- ^ 


[ o* J 


Message boxes that ask stuff 

If you need a message box that asks the users a question, you will need to 
check the return value to see what they chose: 


response = tkinter.messagebox.askyesnocancel("Gift?", "Gift wrap the package?") 


1 

/\ value is assi^ed to Vesyonse a*ftev- 
the usev tlidks one o£ the buttons. 

When tkinter gets to this line, it will wait for the user to 
answer the question and then assign True (yes), False 
(no), or None (cancel) to the response variable. 

Let's see what other message boxes are 
available. 



304 Chapter 8 V 2 




























exceptions and message boxes 



These are the message boxes available in tkinter. Think carefully about 
each of the following examples. We know which we’d use at Head First 
Labs. Which type of box on the left would you choose for each of the 
messages on the right? Gonnect the messages to the boxes with lines. 


showinfo 


“OK to fire boosters?” 


showwarning 


“Your tartan clogs have arrived.” 


showerror 


“Seriously, I think he’s just ignoring the phone.” 


askquestion 


“Danger, Will Robinson!” 


askokcancel 


“Do you want fries with that?” 


askyesnocancel 


“Dude, the printer’s busted.” 


askretrycancel 


“So, you want Nutella on your bacon and jelly sandwich?” 
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mixed messages 



These are the message boxes available in tkinter. You were to think 
carefully about each of the following examples, then indicate which 
type of box on the left you would choose for each of the messages on 
the right. You were to connect the messages to the boxes with lines. 

Ave you REALlV suve you want to 
tontinue and do tbis tbing? It's youv 
last dbande to dbange youv mind- 



“OK to fire boosters?” 

Tbis is puve 'm-fov-rirta-tioh. /Voibmj 
{o y/ovvy about fcxuyi ibc visk o( 
dasbinj y/i-th youv vdvci pixie bood- 

“Your tartan clogs have arrived.” 

|t didnt wovk last time, but it you like, you dan tvy again. 

. 4 / 

“Seriously, I think he’s just ignoring the phone.” 



0 so -tbevds nothi») atiually 

“Danger, Will Robinson!” bvoken YBT, bu*t CARBFUL 

you ave k> C.oh*ti^uC) bu"b 

do you want tbis e*tva option? 

“Do you want fries with that?” 


Y 


S-tu-ff s bvokeK. You y\ted b> know. 


“Dude, the printer’s busted. 


55 


U 




po you want tbis additional option, ov would 
you like to fovget about tbe wbole tbing? 


So, you want Nutella on your bacon and jelly sandwich?” 


pid youv answevs matdb ouvs? Tbey migbt not- Seledting wbidb type of message bo* to use 
depends a lot upon tbe pavtidulav pvogvam youVe wviting and bow sevious you tbink a dedision is 
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exceptions and message boxes 


r ^|^rpen your 



The folks at Head-Ex want your program to display this message 
box if there's a problem saving a record to the 

deliveries . txt file: 


© 

errori 



k ux te io the ^ fle ^ - 


f9 

f l£rr pg Bl Pec rrii^tiOTi d.GP,iGd‘ 

i 


‘deflue* i.eD.ixl 1 




i 


Complete the missing lines in this section of your program to create the message box. 
Hint: You need to include a newline in the message box text. 

from tkinter import * 


def save_data(): 
try: 

fileD = open("deliveries.txt", "a") 

fileD.write("Depot:\n") 

fileD.write("%s\n" % depot.get()) 

fileD . write ( "Descriptiori: \n" ) 

fileD . write ( "%s\n" % descriptiori. get () ) 

fileD.write("Address:\n") 

fileD.write("%s\n" % address.get("1.0 ", END)) 
depot.set ( "") 

descriptiori. delete (0, END) 
descriptiori, delete (0 ^ END) 
address.delete("1.0 ", END) 
except Exception as ex: 
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get the message 



The folks at Head-Ex want your program to display this message 
box if there's a problem saving a record to the 

deliveries . txt file: 



Complete the missing lines in this section of your program to create the message box. 
Hint: You need to include a newline in the message box text. 


from tkinter import * 

tk’m*te\rirnessa^ebo% 

Remewbev- xo 

\mV>ort “tbe 

*e6essav7 module- def save_data(): 

try: 


fileD=open("deliveries.txt", "a") 
fileD.write("Depot\n") 
fileD.write("%s\n" % depot.get()) 
fileD.write("Description\n") 
f ileD . write ( "%s\n" % descriptiori. get () ) 
fileD.write("Address\n") 

fileD.write("%s\n" % address.get("1.0", END)) 
depot.set("") 

descriptiori. delete (0, END) 
descriptiori. delete (0, END) 
address.delete("1.0", END) 
except Exception as ex: 


*tk'm*tcv-.nr\CSsa^cbo%.sboy/c\r\ro\r( w Ev-\ro\r| W , 

,.. 

You should use the showenrorO tWtio* so that 
the dialog box gets the torreti error ido«. 


"Can't Yrt-ite to the -filet %s M % ex) 
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exceptions and message boxes 



Now what happens if you try to save a record when the deliveries . txt 
file is read-only? 


Head-Ex Deliveries 




Descriptiori: 


Bucket of Parmesan 
Address: 


The Holy See Suppliers, Inc. 
42 Vatican Way 
Rorne, Italy 


The idoh shows 
the use\r that 
somethihg has 
0Ohe w\roh<y 


This is an BRROR message bo*. 


i- 




© 


Error! 


Can t write to the file 
[Errno 13] Permission denied 
'deliveries.txt' 




Great! The exception handler displays an error message 
with an icon that really alerts the user to the problem. 
Let's check back with Head-Ex to see if they like it. 


you are here ► 
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durian delivered 



o 0 



That's exactly what we need. And not a 
moment too soon. We just had a delivery 
of durian, the world's stinkiest f ruit. 
Theres no way we want to leave THAT 
delivery too long in the stock room! 



DII HI AN 


The error message box was exactly what 
Head-Ex needed. 

By catching exceptions and displaying 
important information in message boxes, 
you can greatly improve the experience of 
your users when things go wrong. 

Great work! 
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exceptions and message boxes 



Your Prograwwiwg Toolbox 

You've got Chapter 8.5 under 
your belt. Let's look back at what 
you've learned in this chapter: 


* £o**e txr 






\s 


error* . 

*^ c * tc? WYV .. 

tws te ta " ed se o? arv 

* CoAc ^ ^ ariiw . 

ta " cd * ^ d**l **-"■** * 

„ rs t\o«s. , as tt d\a\o^ ' D01te ■ 

T est< . a \ s0 kwo'M»' as 

^ ^ v^A, 


* Me^ e V)0 * CS . wSC r kt 

* <* uw 
vtvf 



p y^oh 7io/ s 

, Vbu«a*i^L 

block. h ex£e piiohs by us - 

* ., y “*» J Vewtrt 

f* «" M» 

*/»L; V'^ 

3 't as a ^ -«sa^ . 

7 ° dispLu ^ ' 

u. , ' d / '•'essjo- l . 


* 7-0 disp/ay —9- by 

^ * » ttd t . 

*— _„_ 


* /M. ^Odu/e. "T^t 1 

•T^ dispW mWi »** - 

.* ■ **“ *«-««* 

Y “' » *“■“ T «* * toe „„ 

* -tw L *“' *** <x. 

*M' “ ^ F »« ■( i k 

c£r* ^ ^ * , k ' *• «. 

tte «f»w w 


you are here ► 
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9 gtapKiCcJ Interface elements 

* Selectincj the + 

* right tool 


lt's easy to make your programs more effective for your users. 

And when it comes to GUI applications, there’s a world of difference between a working 
interface and one that’s both useful and effective. Selecting the right tool for the right job 
is a skill that comes with experience, and the best way to get that experience is to use 
the tools available to you. In this chapter, you’ll continue to expand your GUI application 
building skills. There’s a bunch of truly useful widgets waiting to be experienced. So, turn 
the page and let’s get going. 






Yikes! I was sure the 
salesman said the box 
contained an Ultimate 
GUI Toolkit™ 


this is a new chapter 
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dj goes digital 


Time to mix it up 

Your best friend is an ultra hip DJ with a problem: his vinyl 
collection is now so large that he can’t carry it all around 
from club to club anymore. He’s decided to digitize his entire 
collection, put it on his laptop, and mix his sounds from there. 
His problem is that commercial mixing Software costs a fortune 
and he doesn’t like any of the free alternatives. He has his 
own ideas for the mixing Software he wants. 



What with spending all his time mixing music, he’s never 
learned how to program his computer... and that’s where you 
come in. If you help him to write the Software he needs, he 
promises to showcase your work at the upcoming World Music 
Mixing Expo. 

Let’s build the mixing Software bit-by-bit based on the DJ’s 
requirements. 


/\ll ot -tw.s Kas b> y>- 
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Code Magnets 


A couple of buttons on a GUI ought to do it. Here's the code to a 
small tkinter program that starts and stops a sound file. Rearrange 
the code magnets to make the program: 


from tkinter import * 
import pygame.mixer 


track = mixer.Sound(sound_file) 


trac k_start () : 

track. piaydoop 


s = 


' 1 ) 


stop_button = Button(app, command = track_stop, text = "Stop") 
stop_button.pack(side = RIGHT) 



start__button = Bui-f rm / - - - 

utton(app, command = track <=v I --- 

.ftart_button.pack(side = lrft 1 ' ack - s tart, text = "start") 


def track_stop(): 
track.stop() 


mixer = pygame 
mixer. init () 


mixer 



app = Tk () 
app.title("Head First Mix M ) 
app.geometry( 1 250 x 100 + 200 + 100 1 ) 


you are here ► 
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start and stop 



Code Magnets Solution 

A couple of buttons on a GUI ought to do it. Here's the code to a 
small tkinter program that starts and stops a sound file. You were 
asked to rearrange the code magnets to make the program: 


from tkinter import * 
import pygame.mixer 


Import the v-e<\uived libvav-ies- 


app = Tk() 
app.title("Head First Mix M ) 
app.geometry(' 250x100+200+100 1 


) 


Oeate the (\\A\ applidation x'm<W 
Iden tify the DJ's tv-adk. 

'C- 


sound__f il e 


11 


5045 Q M RED N ephiimi zer 


wav 


n 


mixer — pygame 
mixer.init() 


mixer 


The “tv-adk_stop0" fundiion. 
will respond to the "Stop" 
buiion-dlidk event 



Start the sound system- 

The tv-adk_siav-iO' fundiion u/ill vrespond 

to the "Stav-t" bution— dlidk eveni- 

The “loops - -I" parametev to "playO' 
peats the tv-adk until you stop it- 


track = mixer .Sound(sound_file) 


Load up -the -tva^k sound -file. 


Cveate a bution fov- 
"Stavt" and "Stop,” then 
donnedt eadh ot the» b>\j 
theiv eveni handlevs. 


Stav-t the 6jM| eveni loop 




r 




Download the sound tracks for this chapter from the Heod First Proqromminq 


website. Be sure to put the sound files in the same directory/folder as your code. 
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graphicaI interface elements 



Enter the code from the previous page into IDLE, save it as hfmix . pyw, 
and press F5 to try it out. 


h fm i x * pv w - f h om e/ba rry pftt ea d FI rst P roq /ch a pt er 9/c od eyst a g eo ■ + - 


Fi!c Edit Format Run Options Windows 


The -Piv-s-t vevsioh 
o( the DJs 
pvogvam ehtcved in 

IV LE. 


fr-:-r tkinter import * 
pygame.mixer 

app - Tk( ) 

app. titleUHead First Mix" ) 
app.geometry [ 'Z^oxioo+Zuo^ioo‘ ) 

soimrl file = M HER Nfiphl imi 7ftr,wflv" 

itsixer — pygmne «inixer 
ffiixer.init() 

! - ■ I L idtX aLdit( )i 

track.play(loops - ^1) 

J e I Lx ac k a Lup ( ji : 
track.atopf} 

t racK = mixer.Sound(sound file) 


3 1 a r t bu 11 on = Button(app, coranand = traclt atart F text — "Start" ) 
start Putton.pacKjside = LHFTJ 


3top button = Button(app r coirmand 
stop button.pack{side = RIGHTJ 


= t rack 3 1 op r te xt = 


app . nt a ini oop ( ) 




You already know how to display buttons on a GUI and ( Thafs not a 

associate them with event-handling code. What’s new in this 
code is the loops = -1 bit, which arranges to play the sound 
repeatedly. That is, the track loops. 


That was almost too easy! 


you are here ► 
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stop the music 


The music just kept on playing... 

In his haste to show off your program to his DJ rivals, your friend 
flred up the program as is. He didn’t realize that the track you 
included by default is pretty bad. In a panic, he clicked the window’s 
close box before pressing Stop, and the awful track just kept right on 
playing. His rivals haven’t had such a good laugh in ages... 




0 




0 


o 
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graphicaI interface elements 


Not ali events are generated by button clicks 

Your GUI program processes lots of events, not just the events generated by your 
user when, for instance, buttons are clicked. 

Your operating system can send events to your GUI program, too. Some of these 
events are commonly handled by the graphical programming technology you 
are working with. For most of the operating system’s events, tkinter very kindly 
handles them for you. When you click the close box on your GUI, this generates a 
Window Manager event for your code to handle. If your code doesn’t handle a 
Window Manager event, tkinter handles it for you in a default way, too. 


Youv uscv 
ynev-a-tes a 

eveyrt i* ibe 
^U|. --va 




1 \ \ 



l/Vait -Po\r ahothev cvcht 


\ J / 



^ *he «tt»k-hahdlinj Code 
assotiahed wi-fch whatever 
eveh-t otcwred^r per-for», 
some de-faul-fc attioh. 



■ 

■ Head First Mix f 

i mm 



Start 


Stop 





l\ 


The Whdow /VUager 
9eieva-tes an eveni 

usev clicks 
0h the close box. 


If the default event handling isn’t what you want, you have to capture the event 
before it gets to tkinter and is handled in the default way. At the moment, the click 
on the close box is being handled for you by tkinter and the default behavior is to 
close the window. 


Let's take control of this default behavior. 


you are here ► 
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the cost of interactive loveliness 


Frank: What i up now? 

Joe: Well, it looks like I have to worry about lots of other GUI 
events, not just my own. 

Jim: Yeah. It appears the operating system and this Window 
Manager thing can give the GUI applicatiori work to do. 

Frank: Yes, that i right. All that interactive loveliness comes at a 
cost. 

Joe: Cost?!? You mean we have to pay? 

Frank: No, not that sort of cost. You sometimes need to write a little 
extra code to interact with the Window Manager when and where 
necessary... that i what I mean by “cost.” 

Joe: Phew! So... what i a Window Manager, anyway? 

Frank: Iti something built into every GUI application that handles 
the management of your applicationi windows. Pythoni GUI, 
tkinter, has a Window Manager, as do all the other GUI toolkits. 

Joe: So, how do I work with the events generated by the Window 
Manager? 

Frank: You create a function with the code you want to run and 
then connect the function to the event. 

Joe: OK, I get that. But which event do I connect up to? Iti not like 
the Window Manager has a button to click on, is it? 

Jim: Thati a good question... Frank? 

Frank: Well spotted. What happens with the Window Manager is 
that therei a set of protocol properties that you can interact with as 
and when required. 

Joe: Protocol what? Properties? 


You see , GUIs might look 
nice and easy, but they are 
actually a pretty complicated 
beast under the hood. Theres 
lots of different events to 
worry about. 




Jim: Yeah, you Ve lost me there, Frank. 


Frank: Yes , protocol properties... they really are not as scary as they 
sound. Remember: with GUIs, itfs all just code. 


Jim &Joe: Where have we heard that before... ? 


Frank: Here, let me show you what I mean... 
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graphicaI interface elements 




Study the three tkinter properties presented below and see if you can 
match up the properties to the correct description: 


WMTAKEFOCUS A message sent to your main window 

when the operating system is shutting 
down 


WM SAVE YOURSELF 


A message sent to your main window 
when the close box has been clicked 


WM_DELETE_WINDOW A message sent to your main window 

when the window has been selected 
after a mouse click 


Which of these protocol messages do you think you need to capture? 



The tkinter library provides a mechanism to 
react to an event that is associated with the GUI 
window. These are known as Window Manager 
protocol properties. Think of the event as a 
protocol event. 


you are here ► 
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capture the event 


+ 



You were to study the three tkinter properties presented below and see 
if you could match up the properties to the correct description: 



A message sent to your main window 
when the operating system is shutting 
down 

A message sent to your main window 
when the close-box has been clicked 

A message sent to your main window 
when the window has been selected 
after a mouse click 


You were to identify which of these protocol messages you think you 
need to capture: 


m_D£L£T£jtfWDOW 



Cowtrollmg the Window Mawager 


To capture the event before it gets to tkinter, call your app’s 
protocol () method and identify the function that should be 
called instead of executing the default behavior: 


y'ou'11 have to dv-eate the 

"shutdoYm* ■fuirifrtion- 



Be sure to eall 

yoUolO" BEFORE 

^aihloopO”. 



..v iwnuuon 

vi/ith the property. 
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graphicaI interface elements 



Now that you know about window manager properties and how 
to capture them, write the code for the shutdown () function: 


fore’* U* tode » 


■fav 



from tkinter import * 
import pygame.mixer 


app - Tk() 

app.title("Head First Mix") 
app.geometry('250x100+200+100') 


sound_file = "50459_M_RED_Nephlimizer.wav" 


mixer = pygame.mixer 
mixer.init() 


def track_start(): 

track.play(loops = -1) 


def track_stop(): 
track.stop() 

Put the ^ 

“shutdow * 1 

hev-e- 


track = mixer.Sound(sound_file) 


start_button = Button(app, command = track_start, text = "Start") 
start_button.pack(side = LEFT) 

stop_button = Button (app, command = track_stop, text = "Stop") 
stop_button.pack(side = RIGHT) 


WV>at «eeds 

{p ao V»eve? 



app.mainloop() 


you are here ► 
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shutdown functiori 



Now that you know about window manager properties and 
how to capture them, you were asked to write the code for the 

shutdown () function: 


from tkinter import * 
import pygame.mixer 

app = Tk() 

app.title("Head First Mix") 
app.geometry('250x100+200+100') 

sound_file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame.mixer 
mixer.init() 

def track_start(): 

track.play(loops = -1) 

def track_stop(): 
track.stop() 

drP shu*tdovmO: 

s.m ? ly avrange U Padk.sW) 

•bvadk -to ^. 

when window tloses. 


track = mixer.Sound(sound_file) 


start_button = Button(app, command = track_start, text 
start_button.pack(side = LEFT) 

stop_button = Button(app, command = track_stop, text = 
stop_button.pack(side = RIGHT) 


Call "a?\>?v<+> to ' () 
keW Ee tali +> - 

"ao^.mamloo^O • 


app.mainloop() 


= "Start") 

"Stop") 
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graphicaI interface elements 



'esT DriVq 


With the changes made to your program in IDLE, press F5 to see how things 
perform now. 


Otiose 


op 3^7"' 


■1 hfmlx.pyw ■ /horne, i barryp.'HGadFir&tPr&gi , chapter3;ep(J& l i st«i! 

+ _ 

n 


Fjle Prilit Format 

Riin Optione Wmrlfiw^ 


jjplp | 


t: r t fcmt er . n p or: * 

py ij rimM . m t K h?r 

C) 

app.titlc t "llcad t‘irot 

rtpp_y+fi situ-: i r y ( ■ n *i iid+aflfrH0G * } 

^iiLiuci f j 1^ m ■-ifi4"i<l i _H_RRTl_NK|ilrt im 

ibi khi = pyijrini-*. m 5 x pf e 
miner. S 

11 ■: t rack_sta rt | ) i 

■h rn.r:k . p 1 jbv ■; t LiHnp.^ — 1 ] 

:■ ■ h "fl .T. I" ■‘hp | : 

^ rack. 3 top(j 

.1 e t entitdDwn []: 
track. stoppil ) 




) \ \ 


Head First Mix 



\ 


/ 


track - [Jiisccr. Gourid (3Dund_file ^ 
track_playing - IntVarf) 

gtart_Putton = But tem £app r command=track_3tart r text = "Start") 
s t ait button.pack(aidc - LEFT) 

stDp_button = Button £ app r command = tractk_atop f teate = “Stop" | 
atop button ,pack( eide - RIGET) 


app„pret&col( "WM DELETE WIHDOW" , ebutdo 


app rtr.ainloop (j 


/ \ 


/ 


\ 


±fl*" d *» ^ ll>LB and 

Pytho, Shell to U the 

wihdow xo dlosc. 


What gives? YouVe solved one problem, but created another. 
When the DJ clicks on the close box, the track stops playing, 
which is what you wanted. But now, the window won’t close. 

This carTt be good, can it? 




I you are here ► 
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terminate with extreme prejudice 


Capturmg the protocol event mi enough 

Your code captures the protocol event and redefines its behavior. But, what 
about the behavior that used to execute by default ? 

Take a look at this small example program, which redefines the close-box 
protocol to check with the user before actually destroying the window: 


from tkinter import * 

from tkinter.messagebox import askokcancel 

app = Tk () 

app.title ( "Capturing Events") 
app.geometry('250x100+200+200') 


def shutdown (): ^—_ 

if askokcancel(title 


app.destroy() 


app.protocol("WM_DELETE_WINDOW", shutdown) 



app.mainloop() 



Po this! 




Ckkm$ on Ibe tlose bo* vw>s tbe 

"sWtdowiO” tuntiiom, >wViidb 

disflays a« AskOkCanfcel dialoiy 


|t yoIA tlitk Ot tbe <^UI is 

dest^oyed (v/Wifi-h has ”the ok 

fclosm^ *thc y/mdow)- 


Add the app . destroy () line of code to the end of your 
shutdown () function and see if it makes any difference. 
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'esT DRive 


YouVe added in the line of code that terminates (destroys) your GUI 
applicadon. Now, press F5 to see what happens. 


hfmlx.pyw ■ /hom&/barryp Hea-d FirstProy/chapiers.^ode/ttagi + 


£ilp Trlit Tnrmflt Rnn Ophfvn^ tA/inrifiiws 
f r <m tfcinfccr im p >:■ * 

pu: . pytjioinve.inJ.JUfr 

npp = ) 

app, t itlc ( ’ LJc □ d L i rat Jiix " ] 
opp - y e ume L.r y ( " 2 3 0> 1t’ 0 * 2 50 *-l 00 ' J 

aiJLind rile = M r.H" N e ul l 1 _L mi. zd( . wav" 

nu * 

mi xer = py ciiT.e . mirtfi 

r.ixcr. ir.it | t 

i : t: _ a.GJt_3tQrt 4 J: 

I t ritrTi . pl rfy ^ 1 

I > - f t. T rl L~"fc ^I.CIplJ y: 

tracit. dtop^ \ 



■ 3 hutdown [): 

1.1 .n:V s m.I u[i( j 
app ~ dcdtroy () 

t racJc - cn ner. Sou nd ^ dound_£ i le 1 

tracJc_p±aying - lntVar( \ 

^l.iicl tiiiL.l.i 313 = Plul.J.nn ( np[i p ciCwnmrtmWt.r *icV m I e I. F t.+fx I 
3 tart_bytton .pacJc£ side - UJFTJ 

.“it n_: IillI L.iiei = Rui t.mi [npp, i:rinni.incl = L.i.niik Ml.[»p r I tfxL. 
stDp Putton.pacii (Bids - UltUT] 


Your GUI is not only doing what the DJ wants; it’s behaving itself, too. By 
redefining the protocol event associated with the click on the close box, you 
are able to stop the track... eh... in its tracks. You also ensure that the default 
behavior associated with the click is performed by arranging to destroy the 
GUI applicadon. 

That's great! 



/ \ 

/ 

you dl»dk on “tViC 
dlose bo% y \ ow , *tbc <^U| 
afflidatio* disappears. 

Midb bclps c^lam wby you 

da* “t SCC i*t OY\ *tbis pa$e 

a^ymove! 
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toggle time 


Two buttons, or not two buttons? 
That is the question... 



The DJ is happy with the program so far. However, he thinks it would work 
better if he had just one button instead of two. He’s convinced this would be 
easier to use, because he wouldn’t have to move his mouse around the screen 
quite so much. 



2 buttons or not 2 buttons? * - 



MI the *e*fc clidk 
f" J ov . ^aievet- 

this butfcoh does? 


It is possible to use a single button here but, without changing the physical 
appearance of the button each time it’s clicked, a user can’t possibly know 
what state the button is currently in, even though the DJ does have ears in 
this instance. But, in general, using a button to switch between two States is not 
regarded as best practice in GUI design. 

What your DJ friend actually wants is some sort of visual toggle... 
something that can be flipped between one of two States: on/off, open/close, 
flip/flop, and so on. You need to use a different graphical interface element. 


Is there a GUI visual toggle you can use here? 
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graphicaI interface elements 


& 

ExeticiSe 


Take a look at the following window that appears when you ask a full-featured web browser to 
display its preferences. Grab a pencil and draw a circle around any graphical interface elements 
you haven'tworked with yet. 



F rom the elements that you have circled, identify one that might be of use to you in your program. Which 
would work best as an on/off toggle? 

IMri-te you\r dnsu/etr here- 


you are here ► 
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check on the checkbox 



ExeaciSe 

IvtlOH 


Take a look at the following window that appears when you ask a full-featured web browser 
to display its preferences. You were to grab a pencil and draw a circle around any graphical 
interface elementyou haven'tworked with yet. 


Shir&c&ke Frefarcnces 



Mam 




Pw 

1 

a 0 

Tabs Curitent AppJkdliurih 

Privdey 

SeturiLy AdvariLed 


5-tortup 

when shircCDka start^; 


bhfiw my winrinw 1 ; .mrl r.Th^i fmm l antri me 


Home Page: 

http://w w w. python.org/ 



usc Lunent Iftgcs 

uscj^DQkjmark 

ustore to ucfault 


r—> 




Dpwnba d^ 

0 F-jhow Iho Downln E ift r i window whe n dnwnloariin!] a 
I Close it when af( downloads arefinished 


file 


!# Scivr files ro 


d Gesktop 


Bnowse... 


Aiways ask x me where tn save files 

Add-ons 

change preferenceE for your add-ons 


Managc Add ons., 




i&I Cluse 


F rom the elements that you have circled, identify one that might be of use to you in your program. You 
were asked to identify an element that would work best as an on/off toggle: 

The £he£kbox is 

either oh ov" o-P-P. ^ The dhedkboy. 
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graphicaI interface elements 


The checkbox is aw ow/off, flip/flop toggle 


The great thing about the checkbox graphical interface element is that it can 
be in only one of two States, either on or off. Depending on the current state 
of the checkbox, an object can be set to either 1 for “on” or 0 for “off. 55 



CVitk the thetkW 

to "titk” «t set 
the ofejett to *<» • 



P' tk the ehedkbox k> 
^tidk" ii and set the 
°tjedt to "otf". 



0 





In tkinter, checkboxes are created using Checkbutton (), and they can be 
associated with a tkinter IntVar, first introduced in Ghapter 7. The tkinter 
Checkbutton () is either on or off and sets the associated IntVar to 
either 1 or 0, which is perfect for what you need. 


Let's look at using a checkbox in tkinter. 


you are here ► 
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flip it off 


Working with chcckboxes in tkinter 


The tkinter Checkbutton needs three things: an IntVar to hold its 
current value, an event-handler function to run when it’s ticked, and a 
descriptive label to say what it does. Take a look at this example code: 


The %jtO" 

-fuhetioh is the 

Chedkbut-toh^s 
eveht hahdlev-. 


flipper = IntVar() 


Cirea-te an "In-tl/ar" io hold a value -fcha-fc 
is eithev I or O, depending on whether 
the £hedkbox is tieked- 


def flip_it () : 

if flipper.get() 
print(”Cool. 
else: 

print("Phooey. I'm OFF.”) 


== 1 : 

I f m all ON, man ! 11 ) 


The Chedklou-bton is 
assotiated Wrth the 

"IntVav", links to the 
event handlev, and has 
a destrictive label, too- 


Checkbutton(app, variable 

command 
text 


Usiwg the get() method 



If you look closely at the code for the f lip_it () 
event handler, youil notice that the message displayed 
on screen is controlled by whatever value is returned 
from the call to flipper . get () . The get () 
method is part of every IntVar object, and it lets 
you easily determine, in this case, the current value 
associated with the flipper variable. 

But, what sets the value? 

The Checkbutton automatically sets the value of 
flipper as a resuit of the click on the checkbox. 
Tick the box and the value is set to 1. Untick the box 
and the value is set to 0. 
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r ^harpen your pencil 

Here's your code from earlier. Use your pencil to put a line 
through the code you don't need anymore: 

from tkinter import * 
import pygame.mixer 

app = Tk() 

app.title("Head First Mix") 
app.geometry('250x100+200+100') 

sound_file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame.mixer 
mixer.init() 

def track_start(): 

track.play(loops = -1) 

def track_stop(): 
track.stop() 

def shutdown(): 
track.stop() 
app.destroy() 

track = mixer.Sound(sound_file) 

start_button = Button(app, command = track_start, text = "Start") 
start_button.pack(side = LEFT) 

stop_button = Button(app, command = track_stop, text = "Stop") 
stop_button.pack(side = RIGHT) 

app.protocol("WM_DELETE_WINDOW", shutdown) 
app.mainloop() 

© Write the code you need to implement the checkbox here, based on the sample code from the previous 
page. Give your IntVar the name track_playing. Use track_toggle as your function name, 
and call the checkbox track button: 
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O Here's your code from earlier. You were to use your pencil to put a 
line through the code you don't need anymore: 

from tkinter import * 
import pygame.mixer 

app = Tk() 

app.title("Head First Mix") 
app.geometry('250x100+200+100') 

sound_file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame.mixer 
mixer.init() 


checkbox added 


r ^Jharpen your pencil 

Solutlon 


rief t rack start () : - 

-1 r a ^k pl ny fl o n p n 

us 

de f L r a e ^ — 

— tri°V st"p () 


-— 14 - 

The tundtions that stari and stop 
the tradk are no lon^er needed 


def shutdown(): 
track.stop() 
app.destroy() 

track = mixer.Sound(sound_file) 

otart_b r r b ton — Dutton (app,. —eorum and 
gtarf_hnffnn pnrlr (h iHp = LEFT) 

st ^p_hnt +• on - Button (app r command 
- ni i i m p. i. 1 —Lq i H p = RIGHT) 


Y° u 6By\ also vid of ‘ihe ty/o buttons, 
sinde they arent needed either. 

1 C 

t rari — a- t n * rt r — t e xt —-— "utart”) ■ 

- tcxt — —“" Ctop") 


o 


app.protocol( "WM_DELETE_WINDOW" , shutdown) 
app.mainloop() 

Write the code you need to implement the checkbox here. You were asked to give your IntVar the name 
track_playing, use track_toggle as your function name, and call the checkbox track_button: 

de-P *bradk__to^lcO: 


I!th^r^ ? s^thf" . 'i ~ 1 • .. AII o? this dode needs to 

tradk, based on the state o( tradk flayOoops =• -I) 


the dhedkbo* 


be added to your proy-am 
BTFORE the dall to >?• 
mainloop) • 


else; 

tradkstofO 
tradk_payinj — Intl/arO 

tradk_bwtion — Chedkbutton(afJ>, variable — iradk_j>layin<^ 

ha ^e of the sound dommand — tradk_io<^le, 

Tilc as the te*+ --ddi. . ' . \ 2 '' 

-—-^ — sour\d^+ile/ 


the texi assodiated 
with the dhedkbox. 


tradk_butionpadkO 
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graphicaI interface elements 



With your program amended to include the checkbox code, let’s 
run the latest version of the DJ’s program in IDLE and see if the 
checkbox works as advertised. 



■ hf m i k . py w - ,'h on i *,‘b a r ry p ■ H e ad F i rst P rog/c h <i pte r^ct 

+ - □ K 

| Qilp £riit fflrmiit ]pjn iQprinm 

H^p | 


Head First Mix 


PYq-ttme. mixer 
flpp * TX () 

npp . tiltknf "Krrrtrl I r.T,t 1 

appitjCfURvuLiyj " I m .‘ i-Jt 1 0 f j + 200-*-100 ' j 

aound file - M 313439 r^i JltU NepKiliBiEer.wav 


*s pyqime . ISi-Jlt? L 

niusr, init \ l 



d - ■ t rack toqqI* [ |i : 

L i Hit:>L_p 1 a y idkkf . y u t | p 
tracK.piay( 1 oopa - 


t. t .. St.Upi| ) 

tmcJc - salser. tasund(aound £ilej 
L.r-Ht:fc._pI ay iuy: ■ InLVa.i ( j 

iTJink hut.tnn — Chf^khul”tfinpn[>p r vn.r ii nh-lin 

command 
tlJCt 

traclc tutton.poc Jc { p 


sIuiLdrjwji^ j : 

trAckrfftop () 
app-dcatrcyf) 


app± protOCOl ( "HH_DELZTE_tfIMDOH* , stuildjuw:i } 
app.mainloop(j 


Greating the program bit by bit is working out. Each time 
your DJ friend needs something new, you incrementally 
improve the program in order to provide the functionalilty 
he needs. Of course, there’s always something new. 

Will this guy ever be satisfied?!? 



Svjeet! Towle tke 

on and ott V>Y ^'v 

on tke tkefckW- 
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add a slider 


Puwp up the volume! 


To make the program more useful, the DJ wants to be able to dynamically 
and interactively control the volume of the track as it plays. Basically, as the 
track plays, the DJ wants to fiddle with the volume. 





In the physical world, most devices 
that have a volume control provide 
either a large, circular knob or 
a slider on a scale: 


Softer, softer, 
softer... 


cT” r / 


TV»e tcm-M ^ ^ 

a slider t W 



Because a slider is much easier to manipulate with a click and drag of a 
mouse than a knob, the slider on a scale is used in lots of modern GUIs. It’s the 
classic choice for showing a volume control. 


A; 

••°* r the Conivol 

look like Uis. 
lur» i i up ^ i he 

tijhi down io -the 
lc+i. 


Look closely at the slider. What do you need to model? 
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graphicaI interface elements 


Model a slider oh a scale 


There’s quite a bit going on with a slider on a scale. It’s a simple control that 
everyone’s familiar with, but the simplicity masks quite a bit of complexity. 
The devii is most definitely in the details: 


HevVs ihc s-fcandav-d 
vepresen-tation ot a 
slidcv- ov\ a s^ale -tha-t we 
ali knov/ a*d love. 



TWis end ot ±be sta ' e 
m3 vks a LOW vaW- 


i t ^ l -l I J I- * « I 

T 

Theves a kuntb ot »avkiny on ibe 
devite Ibat indieate ubere on ibe 
stale yow tuv-ren-tly are- 


r 


Tbis end of -tbe stale 
m avks a «W 


FI 


\ 

jre«re is always so*, e -fcUq 

/ OU Oh-to 

ahd s ^e w leti lo 
rtjlvfc. 



youv -fou\r ahswcrs 


1. 



Look at the volume control shown above and identify four key 
characteristics of the volume control. 


2 . 


3. 


4. 
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sound before beauty 


Obarpen your pencil_ 

^ SolutiOH You were to look at the volume control on the previous page and 

identify four key characteristics of the volume control. 

1 ThevVs a sdalc *tha*t y>es -fv-om a low value -to a hig>h value. 

2 The sdale has a -(Wd sei o-f 'miev-vals. 

3 The volume £or\*brol "slider” moves -f\rom le-C”t *bo rijht 

4 Movm^ *the w slidev- w dY^mieally adjusis *the volume based o* iis duv-v-errt 
^osiiioh oy\ ihe sdale- 


Start with the volume 

Before you start worrying about creating the appropriate GUI interface 
element to actually model the slider, you first need to know how to adjust the 
volume of a track. 

Once you know how to adjust the volume, you can then start to worry 
about linking the volume to the slider, with the current position of the slider 
dictating the current volume setting. 

Then you can allow your user to move the slider which has the effect of 
dynamically and interactively adjusting the volume. 


Sounds easy, eh? 
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graphicaI interface elements 


Use pygame to set the volume 

Turns out pygame has this functionality built right into its library code via the 
set_volume() method. 

Take a look at this small example program: 


import pygame.mixer 
from time import sleep 

mixer = pygame.mixer 
mixer.init () 

track = mixer.Sound ("50459_M_RED_Nephlimizer.wav") 
print("Play it LOUD, man!") 
track . play (loops = -1) cii i 

/ ✓ ^ et volupe io a LOUD 

track.set_volume(0.9) seii-ina. 

sleep (2) 

print("Softly does it ... ") 
track.set_volume(0.1) ^Volume *to 

sleep (2) 
track.stop () 



a vevy I ovj setbfi^ 



|~V ■ | |~) 


, p 

t-oudcr, dude, lou<W 


\ 

Tur« that v-atkei <W! 


When you set the track’s volume to a high value using set_volume (), it’s 
the equivalent of cranking up the volume by moving the slider to the right. When 
you set it to a low value, that’s like moving the slider to the left. 
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create the slider 


Use tkinter for everythmg else 

The tkinter library has a graphical interface element called Scale that lives 
to help you create a slider. Take a look at this example code and let’s see how 
it works: 


Creaie a ikmiev- Double\/a\r vav-iable. Like 
bniVar ar\d S-brinjl/av-, -tbe Double\/av- vav-iable 
s-toves a "wagic" valwe, -this -time a -floa-t 


The -tkmtev State 
Widyt treaies a 
slidev-. 


volume = DoubleVar() 
volume_scale = Scale(app, 

variable 


Tbe slidev- dah be Imked 
*t o a w ma<yd” vaviable. 


Spcdi-Py ibe loy/cs-t a*d 
Ihc values o* 

ibe sdale. 

Pvovide a hide, bumah- 
*fvier>dly label (or *tbe . 
slidev-. 


* 


= volume, 
from_ = 0.0, 

to =1.0, 

resolution = 0.1, 

command = change_volume, 

label = "Volume”, 



orient 


= HORIZONTAL) 


volume_scale.pack(side = RIGHT) 



Spedi-fy *tbc 

vesolutioh valuC; 
wbidb 'mdida-bcs tbe 
m*tcv*val- 


4r~ CohhCd-t -febc 
wid 9*t to a» 
dveirfc bahdlcv. 


Clidk 3hd d\rac: 

“tbc slider {o 

tbc volume. 


|r\dida*tc v/bctbcv *tbe slidev 
vuhs advoss *tbe sdveeh 
(HORIZONTAL) ov uf tbc 
sdveeh (VERTICAL). 





The Scale () element is your most complex tkinter widget yet. But, despite 
this, it is not hard to work out what’s going on here. The graphical interface 
element is linked to a tkinter DoubleVar (called variable), the lowest/ 
highest slider values are provided (to and f rom_), and an interval between 
them (resolution) is specified. The event handler is assocated with an 
event handler (command), a descriptive label is supplied (label), and, finally, 
the orientiation of the slider is specified (orient). There’s a lot going on 
here, but none of it is that hard to understand. 
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graphicaI interface elements 


The ScaleO code on the previous 
page has a variable called from , that is, 
the word "from" together with a trailing 
underscore. Was that a typo? 

No, it wasn'ta tyop, eh, typo. The 
reason for the underscore has to do 
with the fact that Python uses "from" as 
a reserved word. These are words that 
Python uses for its own special purposes, 
which means you cannot name one of your 
variables aftera reserved word. As using 
the word "from" makes a lot of sense when 
taking abouta scale, the authors of tkinter 
decided to tack on the underscore so that 
the meaning of the variable would be ciear, 
while allowing for the variable name notto 
clash with a reserved word. 


O: Are there other reserved words? 

Yes, a few. And every programming 
language has its own list. In Python, words 
like "while", "for", "if", "def", "class", and 
"pass" are all reserved words. 

Q: What happens if I use one 
anyway? 


A: 


Python will most likely complain with 
a syntax error. 



Where can I find a list? 


Any good Python reference book 
will contain a list, and it's also included as 
partof the Python documentation that's 
installed with Python on your computer and 
available on the web at the main Python 
website. 


i]iereiare no 

Diimb Oiiebwns 


O: How do I know which graphical 
interface elementto use and when? 


This is really a matter of experience. 
However, a lotof platforms go to great 
lengths to specify exactly when each of 
the elements should be used and for what 
purpose. Of them all, the Macintosh is the 
leader of the pack. Apple's engineers have 
worked hard to strictly enforce consistent 
usage of the Mac GUI among programmers. 


O: So, its a case of anything goes 
with the other operating systems? 


No. That's not what we are saying. 
The Apple folks are very striet with their 
rules and regulations, and the others are 
less so. But there are stili standards that 
you should try as much as possible to 
adhere to. One of the reasons for using 
a GUI is thatyour users will expectyour 
program to work in a Standard way. This 
makes your program immediately familiar 
to new users and lets them become 
productive with your program more quickly. 


Q: So there are no badly designed 
GUlapps? 


No. There are plenty of howlers out 
there... and they tend to be harder to use 
than necessary, due to the fact that the 
programmers responsible forcreating them 
did notconform to established interface 
standards and practices. When it comes 
to GUI programs, conformance is a good 
thing. 


So does tkinter work well on all 
platforms? 


The latestversion of tkinter (which 
comes with Python 3) is pretty good. If 
you run your tkinter program on a Mac, it 
looks like a Mac OS X program, whereas 
on Windows it looks like a Windows 
application, and on Linux ittakes on the 
look and feel of the graphical environment 
you happen to be using (there are a few 
choices on Linux). 


Other than tkinter, what other 
graphical toolkits does Python support, 
and should I learn any of them? 


Python supports lots of other toolkits 
on lots of operating systems. Fornow, 
tkinter is all you really need, and you 
shouldn't worry about the other choices 
until you are in a situation where learning 
how to use them becomes a necessity. 
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control the volume 



fjOH% ExeRciSe 


Take the pygame and tkinter code and combine it to support a volume control. Then, complete 
the next version of your program. 


from tkinter import * 
import pygame.mixer 
app = Tk() 

app.title("Head First Mix") 
app.geometry('250x100+200+100') 

sound_file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame.mixer 
mixer.init () 

def track_toggle(): 

if track_playing.get() == 1: 

track.play (loops = -1) 
else: 

track.stop() 
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graphicaI interface elements 


track = mixer.Sound(sound_file) 
track_playing = IntVar() 

track_button = Checkbutton (app, variable = track_playing, 

command = track_toggle, 
text = sound_file) 

track_button.pack(side = LEFT) 


Add tVie tode 

voluwc 

V^cv-c- 


def shutdown(): 
track.stop() 
app.destroy() 

app.protocol ( !f WM_DELETE_WINDOW" , shutdown) 
app.mainloop() 
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volume controlled 



ExeRciSe 
SoiutioH 


You were to take the pygame and tkinter code and combine it to support a volume control, 
then complete the next version of your program. 


from tkinter import * 
import pygame.mixer 


app = Tk () 

app.title("Head First Mix") 



TWmgs ave starbmj “to 
yt evowded oy\ -bKc ^U|, 
so leVs tkm-tev 
auWat^ally detide 
OY\ *the geometvy -fov 

us. Remove *the w app- 
geometvyO” tali £vom the 
Aode. 


app . geom e try-f " 1 250x100 + 20 0-1^1 "dD" 1 ) 


sound_file = "50459_M_RED_Nephlimizer.wav" 


mixer = pygame.mixer 
mixer.init () 


def track_toggle(): 

if track_playing.get() == 1: 

track.play(loops = -1) 
else : 

track.stop() 


Put the 

pygame tode . 

heve. de-f thange_volume(v): 

*tvadk.sc*t_volumefvolumege*tO) 
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graphicaI interface elements 


track = mixer.Sound(sound_file) 
track_playing = IntVar() 

track_button = Checkbutton(app, variable = track_playing, 

command = track_toggle, 
text = sound_file) 

track_button.pack(side = LEFT) 


pu-t Ue -tkm-tev 
tode Vieve- 


voluime — PoubleVdvO 


volumc.sc*t(*t\radk.5c*t_volumc0) 

volume_s£ale — ££ale(va\riakle 

£ 

o 

> 

W 

-(Vor*_ 

- O.O, 

*bo 

- 1.0, 

resolutio* 

- O.l, 

£omma*d 

— tkah^C__Volunr\C, 

labet 

- VoUe", 

ov-ie**t 

- miZOHTAL) 

volu»>e_stalepatk(sidc — R|£jHT) 


def shutdown(): 
track.stop() 
app.destroy() 

app.protocol ( !f WM_DELETE_WINDOW" , shutdown) 
app.mainloop() 
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test drive 



Let’s take the latest version of the program for a spin in IDLE. In addition 
to turning the sound on and off with the checkbox, you should be able to 
dynamically and interactively adjust the volume with the slider. 



h frrMK. pyw - /hopfl«/binyp/Head F inlPrcg .'ch a pttrlUeed i * - 


fik- E (.fit Fur nidi Ruri QpUQriV WirnJuwv 

LXinLcr . r : 1 * 

r_ pyyame ... mJ.3c.rx: 

app i* Tfc< S 

a pp. titiet "jJead tiret His") 

fi^und file - H HETn NfphUni rfr.wrtv 

mijcrr ■’ pyq-amr . mJ.3c.ri: 
mi 3c.c z . i n i L [ ) 

■ v : 1 r aeX_togg Le fj a 

■ tracKp Laying i get () 

tfack.play4loopa - 

■ 

t.rncik .fttnpij Ji 

tihfljjqr vcj Lunc { v ] 3 

Lc-atri.. a-r L voIludc ( colur.c .ccLj \ 1 

t r a c K - nlxer. Eound ( h c u n d f i la j 
tracKjpioyirag - ln£Var |) 

UU)t_Mttfln - einecXPut ton [ app, variatie 

^nnrnmnrl 

tfrJCt 

Lzfl.HLk._lxu t tu:3 a-liir ■ LEFTJ 

vul u~.ij “ D$j utlcVaz ( | 
voliuw. BetftracX. g#r_voluM r)) 
vdIuh jcoIc ■ Sca 1 e (vari-able 

I r-QiTi_ 

tc-ci 

rflnoluFirm 
rmnuiTid 
la.br! 

HJzienC. 

volurna_Hca Le. gacX ( h i rle- - RIGHT J 

ac t ahutdownf J± 

Cracl.atQpj| 
npp. rir.it.rny f | 


It works. Not only can you 
start and stop the track, 
but you can now adjust the 
volume, too! And all from 
the one GUI... sweet! 
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The PJ is over the wooh! 

Your code has shown the DJ that his idea for the Ultimate Music 
Mixing program is not as far-fetehed as everyone once thought. With 
his idea, talent, good looks, and—above all else—modesty, together with 
your coding skills, the world’s the limit for what you can accomplish 
together. The World Music Mixing Expo is next month, and the DJ 
can’t wait to show off your completed Software. 





Wow! This is really 
fabulous... I can now start 
converting all my vinyl tracks 
and, thanks to your program, 
my laptop is on i+s way to 
being my music mixing desk! 




CtT/j 


J J73 j- 
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CHAPTER 9 


programming toolbox 



Your Programming Toolbox 

You've got Chapter 9 under your belt. 
Let's look back at what you've learned 
in this chapter: 


v tv \na °*tvt 

- * wl ' w „*** V» *■ *** 1 

$Ul eienV tarv „sev. ^ to de 

* «wft- »* ■<“ . A 

J ov OFF- . , er> t a *** r 

* ^ w 

l \ o0 k at «^* r ovoya^s- 

«* r td .d‘* u r* «cal ‘ 

.. - 

a\rhCS* —^ 




'° h Tools 

."' ^Ppdes&W; _ 

m ***z *•* 

^fc/el/d^Q _ ... 

'" “ td fc w ' 

' e£kl *tun . , 9 p * hu *k*- 

^ 4v 

ftflrs 



•^okO _ d 

:,h 9 


'"tyei 


^eaii 


:, »3 
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10 cusioni Widgets and classes 



Requirements can be complex, but programs don’t have to be. 

By using object orientation, you can give your programs great power without writing lots 
of extra code. Keep reading, and you’11 create custom widgets that do exactly what you 
want and give you the power to take your programming skills to the next level. 


this is a new chapter 
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mixing multiple tracks 


The PJ wants to play more than one track 


The World Music Mixing Expo is only a few weeks away. Your DJ friend is 
thrilled with the work youve done, but now he has a few extra requirements. 

Just playing one track isift enough. To be useful, the program needs to be able 
to mix several tracks together at the same time. Each track needs its own 
graphical interface elements (or widgets). 



How will you create the widgets for each track? 

To play and control a single track, you created two widgets on the GUI: a 
check button to start and stop the track and a scale to change the volume. Then 
you added event-handling code to hook those widgets up to the sound 
system. 



Corrtvol 

volume. 



To play multiple tracks together, you just need more of the same. Each track will 
need its own set of widgets and its own event handlers to connect the widgets and 
the track together. Then, each set of widgets needs to be added to the same 
window in the GUI. 


Let's generate the widgets and event handlers. 
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custom widgets and classes 


Create code for each track as a function 

You could just copy and paste the code several times for each track. But 
duplicated code is a bad idea, because it can lead to all sorts of problems 
whenever you need to change how the code for each track works. Instead of 
duplicating code, you should always try to reuse it. 

One way to reuse code is by creating a function that will generate the widgets 
and the event handlers as needed. 



-Cunttion; when £alled> £ould 
create the 'mter-face 'f°' r 5 
siv^le track as needed. 



If you have a function that creates the widgets and event handlers for a single 
track, you could call it for each of the tracks, which would then quickly let you 
build the entire interjace. 


But what code would you need in such a function? 
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new functiori 



fjo h£ ExedaSe 


Here is the code from the end of the previous chapter. Study it carefully, and then, in the 
space on the next page, write the code for your new function (based on the code below), 


from tkinter import * 
import pygame.mixer 


Be<yn by imyortmj tbc 
libvavies yo^ 


app = Tk () 


Cveate -the ^U| applidation. 


app.title("Head First Mix") 

sound_file = "50459_M_RED_Nephlimizer.wav" 


mrxer = pygame.mixer 
mixer.init () 


■■■and ini-fcializ* -t(, e 
sound sysien,. 


def track_toggle(): 

if track_playing.get() == 1: 

track.play (loops = -1) The event-handler Wbo* 

e Ise : detail what hafpens vlen an 

track. stop () — even"t odduvs. 

def change_volume(v): 

track.set_volume(volume.get()) 

Peime Ihe dhedkko* widget- 

track = mixer.Sound(sound_file) 
track_playing = IntVar() 
track__button = Checkbutton(app, variable = track_playing, 

command = track_toggle, text = sound_file) 
track_button.pack(side = LEFT) 

volume = DoubleVar () pe-fme ihe slidev wid^et 

volume.set(track.get_volume()) 

volume_scale = Scale(variable = volume, from_ = 0.0, to = 1.0, resolution = 0.1, 

command = change_volume, label = "Volume", orient = HORIZONTAL) 

volume_scale.pack(side = RIGHT) 



def shutdown(): 




track.stop() 
app.destroy() 


Wandle a dlidk on 

“the dlose box. 


1 


app.protocol("WM_DELETE_WINDOW", shutdown) 
app.mainloop() 

' Start tbe cvcn 


*t loof. 
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function created 



£ohIj ExeRciSe 

§OLutvOH 


Here is the code from the end of the previous chapter. You were to study itcarefully, and then, 
in the space on the next page, write the code for your new function (based on the code below). 


from tkinter import * 
import pygame.mixer 


app = Tk () 

app.title("Head First Mix") 

sound_file = "50459_M_RED_Nephlimizer.wav" 
mixer = pygame.mixer 
mixer.init() 

def track_toggle(): 

if track_playing.get() == 1: 

track.play(loops = -1) 
else: 

track.stop () 

def change_volume(v): 

track.set_volume(volume.get()) 

track = mixer.Sound(sound_file) 
track_playing = IntVar() 

track_button = Checkbutton (app, variable = track_playing, 

command = track_toggle, text = sound_file) 
track_button.pack(side = LEFT) 
volume = DoubleVar() 
volume.set(track.get_volume()) 

volume_scale = Scale(variable = volume, from_ = 0.0, to = 1.0, resolution = 0.1, 

command = change_volume, label = "Volume", orient = HORIZONTAL) 

volume_scale.pack(side = RIGHT) 

def shutdown(): 
track.stop() 
app.destroy() 

app.protocol("WM_DELETE_WINDOW" , shutdown) 
app.mainloop() 
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Begih by i^pov-ti^g 

“thc libraHes you 

»eed io use i» -fehis 
module. 

Cv-ea-te a r\cw -fun^tion 
i\\ai fccmtams tbe ^U|- 

cveatin^ toAt *fv*om “tbc 
duVV-C^t pv-oyam. 


-(Vor* tkna^cy- ir»>po\r^ 

im po)r^ . 



de£ dreata^uifapp, r*i*e\r, souhd_file) : 
de-f -tva^k_to^lcO: 



i-f iradk^layih^ctO ; 
iradkflayOoops 


^-1) 


else: 


“tra^ks-topO 


dc-f dkaK\^C — volum t(v): 

-tvadkse-t_volume^voluw>e.3rt0) 


AII o-f -this dode is pair+ 
o-P ilie Lubo», so i-t 

" eeds ^ ^ indemted. ^5. 



■tradk tt. rr>.v' )< -.C'r Spu^(i(?p^' r '.d^.^' i! t) . 

.ivradk^f.laym.^ =fJniy«rQ . 

-tv-adk_b ~ Ckcdkbutio^fapp, vay-iablc ~ -tv-a£• k_play<«3^ 

dommdndl — ‘tvadk_toftftlc ) 

{,C%{. — sound_-('ilc) 

tv-adk^utWpadkPside — LFFT) 

volurwC — Poublcl/av-O 
volur«e.srt(-tv-adk.3e-t_voluw> eO) 

VolurwC_sdalc — SdalcCvaviabld — VolunnC, -rvom — 0.0, bo — 1-0, 

vesolutiort — 01, dommand — dban<\C_volur*e, 
labcl - ‘Volurwe”, or,e»i - ttORIZOHTAL) 
volu»«c_sdalcfadk(sidc — R|£jHT) 
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functiori in a function 


The new function contains other functions 


With all the code gathered together in a new function, the code for the 
create_gui () function looks like this: 


This -Puhdiioh is 

( L OCAL io ihe 
'WakjuiO" 
-Pubdiioh. 


TWis »s 

UOC AU W 

Men ihis 
*Puhdiioh is 
tellcd, ii siaris 
cxc^uiihg fVor* 
here. 


As aUa^, 
the ta\W 
" ?a tkO” add 
the Vid^ets b> 
the 


from tkinter import * 
import pygame 

def create_gui(app, mixer, sound_file) 
^ def track_toggle(): 

if track_playing.get() == 1: 

track.play(loops = -1) 
else: 

track.stop() 

def change_volume(v): 

track.set_volume(volume.get()) 


'P' -A» tfe „ £J|| d 
* « «foto, tt« e 


TV.ese 3 « tV^e exer-t 

Vmked kfi the «> , 

? ava^etev o? eath 


track = mixer.Sound(sound_file) 
track_playing = IntVar() 

track_button = Checkbutton (app, variable = track_playing, 

command = track_toggle, text = sound_file) 
track_button.pack(side = LEFT) 
volume = DoubleVar() 
volume.set(track.get_volume()) 

volume_scale - Scale(variable = volume, from_ =0.0, to = 1.0, 

resolution = 0.1, command = change_volume, 
label = "Volume", orient = HORIZONTAL) 
volume_scale.pack(side = RIGHT) 


Do you notice anything strange? The new function actually has two other 
functions inside it. Python (and several languages) lets you create local 

functions. A localfunction is just a function inside a function. 

Let's see why they're important for the DJ 's program. 


A lunction-in-a- 
function is callect 
a local lunction. 
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Your H6W fuwctiow wceds to create widgets 
and event handlers 

When you’re wiring up the widgets in the interface, you need event handlers 
to respond to changes in the state of the widgets. If someone clicks the 
checkbox to play the track, the track_toggle () event handler gets called 
and switches the track on or off. 

But if you are creating severat checkoxes, you are going to need a separate event 
handler for each of them. 

That’s why you have locatfunctions inside create_gui () . As well as creating 
new widgets for the interface, it also uses the local functions to create new 
event handlers. 


Each wictget 
needs its ovn 
event hanctler. 









This is 3 yieyi 
Cheekbutton. 


•Vhrrv 


This is a new 


Stale- 


This is a new thetkbo* ^ 
event handlev- 


ihan^e_volu»w tO 

Tbis is a new slidev 
^ event bandlev- 


Now, let's update the program to use this new function. 
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Functions inside of functions inside 
of functions inside of functions... 
now, tha+'s what I call complexity. Of 
course, everythings local, you know. 


Frank: A function inside a function? Surely that’s not legal? 

Jim: Well... it depends on the programming language. 

Joe: Don’t teli me this is something that only works with Python?!? 

Jim: No... there are lots of programming languages that allow you 
to put a function inside another function. 

Frank: Name one (other than Python)! 

Jim: Pascal. 

Frank: Pasc... what?!? 

Jim: Look, it really doesn’t matter which programming language 
supports this feature. What is important is that we can do it. 

Frank: And by “we” you mean “Python.” 

Jim: OK, yes. Python can do it. 

Frank: Thafs all I was trying to say... 

Joe: So, this is cool how? 

Jim: Because it lets you localize functionality and handle complexity. 
Joe: What?!? 

Jim: Look: if a function gets big and complex, it can help to break 
the function down into a collection of smaller functions, just like we 
do when programs get big. We can keep the functionality local to the 
code that needs it inside the function. That way, we keep things as 
simple as we can 

Joe: Even if the code itself is complex? 

Frank: Like the GUI-building code we are working on now? 

Jim: Yes. 

Frank: OK. A function of functions it is, then. Em all for keeping it 
simple, stupid. ;-) 

Joe: Yes, I like KISS, too. 

Jim: Yeah... their last album was really something special, wasn’t it? 

Frank & Joe: Eh?!? 
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E%eRci$e 


Begin by putting the create_gui () function in a separate module called sound_panei. 
py. Then, write a new version of the hfmix.pyw program that uses the sound_panei .py 
module: 

yVv-i-te yoi/v t ode heve- 
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sound pane! 



ExeRcvSe 

SoiyttOH 


You were asked to begin by putting the create_gui () function in a separate module called 
sound_panei.py. Then, you were to write a new version of the hfmix.pyw program that 
uses the sound_panei. py module: 


-(Voim *tkin*tev* impo\rt ^ 

/mpo\r-t all -the 

TUhd-tiohs *Pvom -rv-om sound^J>anel impo\rt ^ 

"the new module. 

impo\rt py<jame-mi%ev- 


app — TkO 

app trtle^ttead Fiv-s-t Mi*”) 


miy.e\r Pt; 
mi*eir.ini*tO 


By eallmg *tke nev/ ^ 
-func-tion TiVlCB, y° u \^ 
eveate Tl NO sets o£ • • • • 
sound £on*brols on “the 

$U|. 


£\rea;te__gui(app, mi*eyy 
£\rea;te__3ui(app, mi*eyy 


de-f shu*tdovmO: 


_REIP_N cp Kj|mi3Ler.way w ) 


^a^k.s-bpO 

appdestroyf) 


app•.py;o;bo£ol ( 'WM sku-tdown) 
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Tesr 


DriVs 


With the code typed into IDLE, take this latest version of the DJ’s program 
for a quick spin by pressing F5. 


These dhedk butW> 






Head First Mix 


Volume Volume 

50459_M_RED_Nephlimizer.wav 1^ 49119_M_RED_HardBouncer.wav 0.1 0,9 


I 








T\\tst sdalcs to*bco\ 
-the VoluimC- 


The program has created a checkbox and a volume slider for each track. 
The program called the create_gui () function twice, creating two sets 
of widgets. Of course, you can call it as many times as you like and the 
create_gui () function will create the two widgets for each track. 

When you click on the two checkboxes, the two tracks both play at the 
same time\ You can start and stop each of them independently by selecting 
and deselecting the checkboxes. But more than that, the volume sliders 
independently change the volume of the tracks, allowing you to mix them 
together. 

This is a big deal. The create_gui () function is not only creating the 
separate widgets and adding them to the interface, but it is also creating the 
event handlers that allow each pair of widgets to control each separate track. 
Here the program is controlling just two tracks, but if you added more calls 
to create_gui () in the code, there’s no reason why you coukkft get the 
interface to work with as many tracks as you like. 

Let's see what the DJ thinks. 
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confusing interface 


The PJ is confused 

The program does exactly what the DJ wants, right? Well, not quite. 


How am I supposed to 
know which volume scale 
is for which track? 


The problem is that even though the program technically works, it has 
a confusing interface. All of the checkboxes are added on the left of 
the interface, and all of the volume Controls are on the right. 

There’s nothing in the interface that indicates which volume scale 
goes with which track. 



Head First Mix 


O 


i 



Volume 

[7 50459_M_RED_Nephlimizer.wav 17 49119_M_RED_HardBouncer.wav 0.1 


Volume 



« 






The checkboxes are labeled with the filename of the track, but the 
volume sliders aren’t. Even though each volume slider is linked to a 
single track, there is nothing in the interface that telis the user which 
track that is. 

So... what to do? You could just add labeis to each volume slider. 

That would probably fix it, but adding more widgets, like labeis, can 
make an interface more complex. And you want your interfaces (and 
your GUI code) to be simple and clean. 

Fortunately, there is a way of rearranging the widgets in the interface 
to make it a lot cie arer. 

To avoid £orvfusior>, / 
£jU| needs *to look 
like *tkis. 
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(rroup widgets together 

If the interface were laid out with the checkbox for a track grouped 
alongside the volume slider for the same track, it would look better. 

Each track could then have a row of widgets associated with it. As long as you 
know which widgets belong to which track, you can load a lot more tracks at 
once without the checkboxes and sliders getting separated (and without your 
users getting confused). 

The program currently uses a function to add the checkboxes and sliders to 
the interface one widget at a time. If you call the function several times, the 
computer creates two more widgets with each call. But the widgets are not 
grouped. So, how do you group widgets together in a GUI interface? 

Create a wew type of widget 

What if you don 3 t just hand the computer a set of instructions? What if you 
give it a brand new widget instead? 

If you create a new kind of widget that groups a checkbox with a slider, 
you can add your new widget to the interface and then guarantee that the 
checkbox and slider stay together: 



O 





■ 1 ■ 1 1 B .“fj 

sfoiume- 

rVf * 

• - . -ill 11 J .1 . 1 1 U UfBI ■ 'f rglJf I M 

\j m 

* m 

p /1 ’ c _noJ?Et) . 

■ . i. ... 

volume 

- \)f- 

i JIIwb—■ 

\J m 

j i^i i 11 


Youv ttCVJ vad^t 
"^Iwes -bo$e-tV>«-” 
■the othev wdftets 

so they aUays 
sta7 y row^ed 



Your new widget becomes a new building block for your GUI interface. 


So, how are new widgets created? And how do they work? 
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frame widgets 


A frame widget contains other widgets 


Most GUI libraries (including tkinter) let you create custom widgets from a 
set of other components, and tkinter includes a special kind of widget called 
a frame. A frame works just like a picture frame, in that it surrounds other 
things. It’s rectangular and it can contain other widgets: 


j\ is like. 
a -frame- 



In tkinter, a frame is created using Frame () . If you can work out a way to 
create a new type of frame (called, say, SoundPanel) that contains the checkbox 
and the slider, then you could use code something like this in your program: 


Create a *ew 
SouhdPahel 
widget- 


These are the same parameters you 
passed to the U dreate__gui0 method- 



You ea* add your widget to the 
£jUl usmg the paeker, just like 
with all the other widgets. 


This look like a great solutiori. However, you stili have a big problem. 



Even though you 
haverft created the 
SoundPanel code 
yet, let's replace the 
calls to create_ 
gui () in hfmix. 
pyw with these lines of 
code now. Just don't try 
to run it yet. 


This code uses an entirely new type of object, a whole new kind of 
widget that has never existed before. How do you teli the computer to create 
something like that, which is effectively a custom GUI object ? 


How do you convince the computer to create a new 
widget each time you call SoundPanelQ? 
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Wouldn'+ it be dreamy if there 
were a way in code to create an 
entirely new kind of widget. But 

afantasy... 
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programming class 


A class is a machme for creatmg objccts 

Object oriented programming (OOP) languages (like Python) let you create 
an entirely new kind of object using a class. A class is like a template that you 
use to create new objects. 

Think of the class like a cookie-cutter , and think of the object as the cookie 
that is created based on the class. As all the cookies are created from the same 
cookie cutter, they all have the same characteristics, even though they are 
all individual cookies. When an individual object is created from a class, it’s 
referred to as an instance of that class. 

So, if you can arrange for SoundPanelO tobea class, you can create 
custom widgets as required: 



leed a hew 
SoundPanelO da«. 


SoundPanel 



T , CU /£S tveates Od^C Ts, 
T iHSTAHCes o? 0* tlass ' 





You need code that creates a new grouped widget in the GUI every time you 
make a call like this: 

Use -the dlass -to dv-eate a *ew objedt 

panel = SoundPanel(app, mixer, "49119_M_RED_HardBouncer.wav") 


Let's define a SoundPanelO class. 
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A class has methods that define bchavior 

The SoundPanel () class creates a new kind of tkinter Frame (), and you 
can specify this relationship using the code like this: 


This says -tha-t we are 
de+iniing a hew CLASS. 



As well as the what (it’s a frame), you also have to worry about the how , which 
will define the behavior of your new widgets. To do this, you need to add 
methods inside the class. To understand how this works, imagine you have 
created an alarm button object from a class. The alarm button will need to 
know what to do when somebody hits it: 


Indicate that the 

new elass is a type oP 
Frame. 

The MFTttOPs oP the dlass 50 here. 
The word w method” is used in 00 ? 
'mstead oP the Word "Punfction. 


Uh-oh, someone just 
hit me. I'd better ask 
the class that made me 
what I should do. 


f 

This will be a method 
inside the alarm 
buttoir/s elass. 


10 ALARM! 

0 


Ca 



class AlarmButton(Frame): 
def button_hit(self): 

klaxon.hoot__loudly() 





The method telis the button how to 
behave when somethin^ happens. 


Someone moves the volume slider. 


You need to create some methods for the new SoundPanel () 
class. Which of the following behaviors do you think you need to 
create methods for? Draw a circle around each one: 


Someone clicks the checkbox. 


w 


The computer starts up. 


You get to the end of the track. 


Create the interface. 
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necessary methods 




The computer starts up. 


You needed to create some methods for the new SoundPanel () 
class. You were asked to identify which of the following behaviors you 
thought you needed to create methods for: 

You vc alv-eady dv-eatedv 
everri handlevs ibat ^ 
do sometiVinj} like *bV>is. 



You get to the end of the track. 



do you heed 
N io do {o dveaie 
“tlc ih-tev-Pade? 


the rei are no 

Dumb Qiiestipns 



Why is there a method to create the widget? 


There isn'ta method to create the widget. Butthere is a 
method to create the interface. That method will run immediately 
afterthe widget is created. 


Q: I don't get it. What's the difference between a widget 
and an object? 


A widget is a particulartype of object. It's an object that you 
can add to a graphical user interface. 



So there are some objects that are not widgets? 


Absolutely. Most objects are used behind the scenes in 
programs. AII of the numbers and strings you Ve used so far have 
actually been objects. 



So you can'talways see objects on the screen then? 


No, most objects run quietly in memory and they don't have 
any display at ali. 



Is Python the only object oriented language? 


Lots of languages-such as J ava, C#, and Ruby-use 
objects to handle complexity. 


Q.: So learning object orientation is a 
into other languages? 


good way of getting 


Yes, understanding object orientation gives you a insightinto 
how other languages think. 
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Put how does aw object call a method? 

To see in more detail how the new SoundPanel widgets use the methods in 
the SoundPanel class, let’s look in more detail at just one of the methods. 
What happens if someone clicks on the checkbox within the widget? 


Hey, someone clicked 
the checkbox. The event 
handler for that is called 
"track_toggle". What happens 
now, SoundPanel class? 


O 


o 


MQ^uroe 


0 





TWis is tV>e c-ode -to 

"-tvatM^eO" «etW- 




C~'~ 


The etKod -takes a 
single parame-fceir. 




def track_toggle(self) : 

if self .track_playing.get () 
self .track.play(loops = 
else: 

self .track.stop() 


The method you need to add to your class should look familiar. This code 
is almost the same as the track_toggle () event handler we created 
before. The only difference is that this method is a little more selfish. 


sel-P idehti-Pies the 
widget £allmg the 
method. 


self idewtifies the widget calliwg the method 

The methods in the class are going to be used for lots of objects, so the code 
in the class needs some way to know which SoundPanel object it is working 
with at any point in time. It does that with the self variable. 

The self variable is passed to each of the methods in the class automatically 
by Python and it identifies the current widget object being used. By adding 
“self .” to the front of the objecfs variable names in the class code, you 
make sure the code is using the data that belongs to the current widget. 


Let's add some methods to the SoundPanelO class... 
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class replaces functiori 


The SoundPanel class looks a lot like the 
createjguiO function 

If you convert the original change_volume () function to a method and 
add it to the class, you end up with code that looks rather like the original 
create_gui() function: 



In fact, the new SoundPanel () class can completely replace the code in 
the sound_panel. py file (as create_gui () is no longer needed). 

But before you do that, there’s stili a little more code to write. The class needs 
to be told what to do when the brand new SoundPanel () is created. The 
class needs an initializer method that knows how to create instances of the 
class. 

'V 

Sor»e prograrnming languages dall these 
initialia methods COMSTRUCTORs, because 
they detail what happens when a new obiedt 
is cv-eated «■ %nsWted" J 


Let's create the initializer for the SoundPanelO class. 
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Code Magnets 


WeVe started to create the initializer code for you, but there are stili a few 
parts missing. See if you can work out where the missing code fragments 
fit. Here is the code that creates a SoundPanel () object. Position the 
code magnets properly to complete the method: 


def _init_(self, app, mixer, sound_file): 


Frame._init_(self, app) 

Bedau.se SoundPanel0 inhevrb Fom 
tk'intev’s pvameO, you need b> te suve 
to iniiialize the Fra»eO dtfORB you 
initialize Fe SoundPanelO. 


track_button = Checkbutton( 


, variable = 


r 


command = self.track_toggle, text = sound_file) 

track_button.pack(side = LEFT) 


self.volume.set(track.get_volume()) 

volume_scale - Scale ( , variable = self.volume, from_ =0.0, to = 1.0, 


resolution = 0.1, command = 

label = "Volume", orient = HORIZONTAL) 
volume_scale.pack(side = RIGHT) 


r 
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initializer constructed 



Cocte Magnets Solution 

We've started to create the initializer code for you, but there are stili a few 
parts missing. See if you can work out where the missing code fragments 
fit. Here is the code that creates a SoundPanel () object. You were 
asked to position the code magnets properly to complete the method: 


def _init_(self, app, mixer, sound_file): 

3 douWe y Frame._init_(self, app) 

ur\dev-s£ov-e at 


erttav side ' 
ttc v^ovd 


/ 


£atb Sour\dPair\clO 

objefrt bas its ovm tv-aC-k- 



fcdth SoundPSandO obje^t bas its 

ovm dbedkbo*. 


track_button = Checkbutton( 



, variable = 


command = self.track_toggle, text = sound_fil 


track_button.pack(side = LEFT) 



self.volume.set(track.get_volume()) 


volume_scale = Scale ( | self | r variable = self.volume, from_ = 0.0, to 

/> 

dPa«elO V 
s\» dcv- 


= 1.0 


pa6b Soun 

«tyefct has Vfcs *** 


resolution = 0.1, command = 



label = "Volume", orient = HORIZONTAL) 
volume_scale.pack(side = RIGHT) 


class s methods+ data 

The SoundPanel () class has methods that define the behavior 
that it implements. In addition to the methods, the class also 
has to detail the data that it holds. For the SoundPanel () 
class, this data is made up from three things: the track to play, 
its checkbox, and its associated slider. 
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The Class Baqposcd 

This week’s interview: 

Life in senior object management. 


Head First: Helio, Class. It’s good of you to find 
the time to speak to us. 

Class: I assure you the inestimable pleasure is all 
mine. 

Head First: So, to begin... 

Class: One moment... <hums> 

Head First: Fm sorry. WhaFs that? 

Class: Apologies. Just checking my initializer. I 
always do it when I create. 

Head First: Ah, yes. ThaFs your constructor, isn’t 
it? The method you use to create objects? 

Class: Well, F m aware that some people refer to it 
as a constructor , but I prefer initializer. I don’t use 
it to create objects, you see. I just use it to configure 
them once theyVe been created. 

Head First: You have a lot of methods? 

Class: Oh, more than you can possibly imagine. 

Head First: In the code we Ve just seen, the 
SoundPanel () class, there were only three 
methods, weren’t there? 

Class: Oh, dear boy, there were only three methods 
defined explicitly in the class. But SoundPanel () 
inherited many, many more methods from its parent 
class, dear old tkinteds Frame () . 


Head First: Frame () has a lot of methods, too? 

Class: Too many to discuss, really. There are 
methods to paint components on the screen and 
details of what to do if things change size. Frame 
is a fearfully busy fellow. <beep beep> Excuse me. 
Helio? Yes? No, you need to stop playing track four. 
No, no, it’s quite all right. Goodbye. 

Head First: One of your objects? 

Class: Yes. They keep me very busy, but Fd miss 
them if they didn’t call. 

Head First: I believe when someone calls an object 
method, the object always asks you to get involved? 

Class: Yes. Fm in charge of the objecfs behavior. I 
do think it is so important to behave properly. Don’t 
you? 

Head First: Of course! Class, thank you. 

Class: Love the tie, by the way. 
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C®de Review 


It’s always good every once in a while to check back on the state 
of your code and make sure everything’s looking spiffy. This is 
what your program should look like at this point. It’s probably 
worth checking to make sure everything in your code looks like 
this: 


hfinix.pyw 
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Soimi.panel.py 

from tkinter import * 
import pygame.mixer 


An irntolizcr «ettod ton.es Note that this j» ** 

ta || e< j[ «_ini-t_0” m Python in ordev- to loe talled auWatitally 

when the okjefrt is treated- 


class SoundPanel(Frame): 

def _init_(self, app, mixer, sound_file) : 

Frame._init_(self, app) 

self.track = mixer.Sound(sound_file) 
self . track_playing = IntVarO 

track_button = Checkbutton(self, variable = self.track_playing, 

command = self.track_toggle, text = sound_file) 
track_button.pack(side = LEFT) 
self.volume = DoubleVar() 

self.volume.set(self.track.get_volume()) 

volume_scale = Scale(self, variable = self.volume, from_ =0.0, to = 1.0, 

resolution = 0.1, command = self.change_volume, 
label = "Volume", orient = HORIZONTAL) 
volume_scale.pack(side = RIGHT) 

def track_toggle(self): 

if self.track_playing.get() 
self.track.play(loops = 
else: 

self.track.stop() 

def change_volume(self, v): 

self.track.set_volume(self.volume.get()) 
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test drive 



OK, so you’re finally ready to start up your new custom widget code. This 
is what it looks like after you bring your code into IDLE and press F5: 


\ * J13 / 





Head First Mix 




_ n 


Volume 


^ 5D459_M_RED_Nephlimizer.wav 


0.9 



Volume 

1^ 49119 M RED HardBouncer.wav 0.1 




J- 


The checkboxes and volume scales are now grouped together on the 
same widget within the GUI. From now on, you will know that the 
widgets on your GUI will always stay together as the SoundPanel () 
class has grouped them for you. 
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custom widgets and classes 


tfiereicffe no 

Dumb Questions 



I don't get it. What's this "self" thing again? 


"self" is a variable that refers to the calling object. 


O: 


The calling object? What does that mean? 


Imagine you create a new method called bleep () in 
the SoundPanel class. An object called panel can use 
the bleep () method as needed, and when it does, it calls the 
SoundPanel class. The "self." bit ensures that the bleep () 
method associated with the panel object is called, not some 
other bleep () method associated with some other object. 



So objects dorTt actually own their own methods? 


In some languages, such as Ruby, they can, but in most 
languages, no, objects don't own their own methods. The methods 
ali belong to the class thatcreated the object. 


But why do I need to add "self." to the startof the 
variables? 


Because then you are changing data inside the current 
object referred to by "self.". You will be working with the object's 
own data, and not with data that belongs to the class. 


Not all the variables had "self." at the beginning. Why 
is that? 


Ifyou lookatthe code, the volume_scale variable 
does not begin with "self.". That's because the object does not 
need to keep trackof the volume_scale variable once the 
initializer method has finished creating the object. volume_ 
scale is a variable that is local to the initializer. 



BULLET POINTS 


■ The SoundPanel widget is a type of frame. 

■ Objects get created by classes. 

■ A class has methods. 

■ The methods detine the beha vior of the 
object. 

■ When an object needs to know whatto do, 
it calls a method in the class thatcreated it. 


The methods in the class all have a self 
variable. 

The self variable points to the object 
that called the method. 

By prefixing variables with "self." you 
can keep each object's values separate 
from each other. 
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add the tracks 


The PJ has an entire directory of tracks 

The DJ is so impressed by how usable your program is that he wants to 
try it out tonight for his complete set, prior to its official unveiling at 
the World Music Mixing Expo. The DJ needs to work with a lot more than 
two tracks. In fact, he has an entire directory full of loops. 


piv-ed-fcov-y 
-full o£ loops. 
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49119_M_RED_H 

ardeouncer.wav 


50459 _I 4 _RED_N 
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50643 _M_RED_ W 592 64 _N _RED_T 
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_dnhiik_,T(nri_?ir 
tri bution.txt 


lnfrnix.pyw ^onnri_panel.py 


13 Itcms Q 4.5 MB), Frcespacc: 4.7 GB 


I want to use all 
of these loops. Can 
your program add all 
of these WAV files 
to my interface? 


O 


Now you could just change the code to add the extra hies to the interface, 
but the DJ wants to be able to manage which tracks the program uses. 

So you will have to find all of the WAV hies in the current directory and 
then add them to the interface when the program starts. 



i 


/ 


Let's get this thing to work. 
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custom widgets and classes 



Poo] puzzjc 


Your job is to take segments from the 
pool and place them into the blank 
lines in the code. You may not use 
the same segment more than once, 
and you won't need to use all the 
segments. Your goal is to complete 
the code in hfmix . pyw so that it 
reads all the tracks from the directory 
and then adds them to the GUI interface. 


from tkinter import * 
from sound_panel import * 
import pygame.mixer 
import os 

app = Tk () 

app.title("Head First Mix") 


mixer = pygame.mixer 
mixer.init () 


def shutdown(): 

track.stop () 

app.destroy() 

app.protocol("WM_DELETE_WINDOW M , shutdown) 


Note: each thing from app .mainloop () 
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tracks added 



P®®1 Puzz]c 

Your job was to take segments from the 
pool and place them into the blank 
lines in the code. You could not 
use the same segment more than 
once, and you didn't need to use 
all the segments. Your goal was to 
complete the code in hfmix . pyw 
so that it reads all the tracks from the 
directory and then adds them to the GUI 
interface. 


You need *to “talk 

of>evat'«3 system, so 




from tkinter import * 
from sound_panel import * 
import pygame.mixer 
import os 


imPov-t *t^e w os module- 

app = Tk() 

app.title("Head First Mix") 

^et «a*«es ok all 

mixer = pygame.mixer -the m the twvvent 

mixer. init () J diyedtovy 

Take eath ot the dirList = os.listdir(”.") 

-filenames... for fname in dirList: 

if fname.endswith(".wav"): 

and i-f it ends in w .wav w ... panei = SoundPanei (app, mixer, fname) 

panei.pack(j 

...dvea-te a / def shutdownO: 

SovmdPa«elO av>d add track.stop() 

\{, “bo “tViC $U|. app.destroy() 

app.protocol("WM_DELETE_WINDOW", shutdown) 
app.mainloop() 


TWis wasnt 
needed- 
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custom widgets and classes 



With the code in IDLE and all the sound files in the directory, press 
F5. You should see something that looks a lot more powerful than 
the simple two-track mixer you had before: 



V 



Every single track from the directory now appears on the 
interface and can be individually controlled. The program looks 
like it finally does everything the DJ wants. But the real test will be 
how it performs at World Music Mixing Expo... 
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programming rocks the house 


Ifs party time! 


k. J 

The wixer program brought the house 


down! 


The DJ took your program to the World Music Mixing Expo and rocked 
the house, with your name in lights! By using classes for the widgets and 
creating an object oriented program, you made your good program (and 
the DJ’s performance) great. 


Object orientation is meant to help you create complex programs with 
very little code. A lot of languages use object orientation, and not just 
for graphical user interfaces. You can use objects to build web applications 
or simulators or games. Any time you need to write an advanced program 
but don’t want your code to turn into a tangled mess of spaghetti, object 
orientation can come to the rescue! 

Cowgratulatiows! 

You got to the end of the book! And what a great journey ifs been. You Ve 
ruled with control statements. You Ve powered-up your programs with 
modular code. You Ve made graphical user interfaces that sing and, finally, 
you took your coding skills to the next level with object orientation. 

Well done! 



382 Chapter 10 




custom widgets and classes 



Your Prograwwiwg Toolbox 

YoiTve got Chapter 10 under your belt. 
Let's look back at what you've learned 
in this chapter: 
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go forth and program 


leaving town... 



Ifs been great having you here in Codeville! 


We’re sad tO see you leave, but there’s nothing like taking what youVe learned 
and putting it to use. YouVe just beginning your programming journey and weVe put you in the 
driving seat. We’re dying to hear how things go, so drop us a line at the Head First Labs web 
site, www.headfirstlabs.com, and let us know how programming is paying off for YOU! 
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appendix i: lefoVers 

The Top Ten Things 4 - 

# (we didn't cover) 



You’ve come a long way. 

But learning how to program is an activity that never stops. The more you code, the more 
you’ll need to learn new ways to do certain things. You’ll need to master new tools and 
new techniques, too. There’s just not enough room in this book to show you everything 
you might possibly need to know. So, here’s our list of the top ten things we didn’t cover 
that you might want to learn more about next. 


this is an appendix 
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proper python 


#1: Poing tbings "The Python Way" 


Throughout this book, we have very stubbornly resisted writing 
code in the most correct Python Way. “That’s not how a Python 
programmer would do it,” was a familiar refrain heard from the 
Head First Programming technical reviewers. Without fail, and with the 
greatest of respect to our reviewers, we generally ignored this advice. 

You see, every programming language has its preferred, tried and 
true, agreed, and accepted way of doing certain things, collectively 
known as programming idioms. And Python is no exception. This is, 
of course, a very good thing, because the more programmers 
using a particular language who follow the Standard way of doing 
something, the better. Except, that is, when writing a book like this: 
one designed from the get-go to teach programming concepts. 

There are times when the idiom, although very smart, can be hard 
to understand and even harder to explain. So, when we had a choice 
between showing you how to do something in a generic way over 
showing you how to do it the Python way, we nearly always chose 
the former approach over the latter. This has the effect of making 
some of the code in this book positively repulsive to hardened 
Python programmers, something that is of little concern to us, as 
this book isn’t for them (and they have lots of other books already). 

This book is for you: the reader who wants to learn how to program 
regardless of the programming language chosen. 

Having said all that, if you now want to learn more about The 
Python Way , start by scanning through the booklist and book reviews 
maintained on the main Python website: 


|http:/ / wiki.python.org/ mc 

dn/PythonBooks 


k . i 
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Learn lois about Python tnom 
yviav-k Lwty dlassit, "Leavnin^ 
Python, T' 1 Editior,,” whith now 
dovens Python 3 and ynevious 
neleases. 







leftovers 


*Z: Using Python l 

If you remember way back in the Readme, we stated we were 
using release 3 of Python in this book. Of course, there’s much 
more to Python that just release 3, as the previous version of the 
language, release 2, is stili very, very popular. 

And rightly so. Python 2 has been around for nearly a decade 
and has an impressive collection of technologies built around it, 
including Google’s App Engine , the Django Web Framework , Zope’s 
Content Management System , and the Twisted .Networking Libraries (to 
name just a few). 

Despite all the Python 2 goodness out there, we stili went with 
release 3 for this book and our reasoning was very simple: better to 
go with the future than settle on the past. The good folks that bring the 
world Python have stated that Python 3 is where all the cool, new 
stuff will happen with the language. Release 2 has entered what’s 
known as bug-fix mode only: if something is found in 2 that is broken, 
itTl be fixed, but no new features will be added. 

And here’s the good news: there’s not much difference between the 
code you Ve been writing for Python 3 and what you would write 
for release 2, should you find yourself in the position of needing to 
(perhaps as a resuit of needing to fix some existing Python 2 code or 
working with a technology that’s based on Python 2). 

Here are a few lines of Python 2 code that highlight some of the 
differences: 


ij» puthon 


Python l, ihe " 
is called "inputO". 


trawJnp^O" tuitio* 
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java, c#, et al 


*$: Other programming languages 


When it comes to teaching programming concepts, there’s more 
than enough to cover without trying to cover multiple programming 
languages. 


We like Python and hope over the course of this book that youve 
grown to like Python, too. However, if you want to explore or need to 
learn another programming language, there’s lots of help out there. 
Simply going to your favorite search engine and typing in the name of 
your chosen programming language produces a torrent of sites offering 
to provide you with everything you need to know. 


Two modern languages that are important are Java and C#. And 
guess what? If you have to learn these technologies, Head First Labs has 
you covered. 


6\ass\6, 

i» Vb Sefcmd 
bdb 0 *' 




Ver y 9 °od, -too 


Having completed this book, you can now pick up either of these books 
and confidently work your way through them. 

Of course, if you find yourself working in a Java or C# programming 
environment and missing Python, don’t despair. Two active projects 
within the Python Gommunity integrate Python with the above 
programming languages and are well worth checking out (search on the 
project name to learn more): 


Run Python CoAt 
wrthm -tbe Java - 
Wiual Madhmc. 



/ronpytho 

.... .1 


M vik C# ^ HtT 
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#4: Autowated testing techwiques 

And, no, before you ask, this has nothing to do with program-testing 
robots automatically testing your code for you (which, we agree, 
would be nice). 

Automated testing does have everything to do with trying to make 
sure, as far as possible, that your code is working properly. 

But, how is this possible? 

The truth is, it’s very hard to know for sure that your code is working 
perfectly 100% of the time. Programs and Software Systems are 
complex beasts. Over time, they grow, and it gets increasingly hard 
to know for sure if they are working quite the way you want them to. 

To help, programmers test their code. When they are done, they 
test, test, then test some more. And just to be sure, they test again. In 
fact, programmers often test to destruction , which refers to attempting 
everything they know to try and break the program and make it 
misbehave. If testing finds a problem, the code is then fixed so that 
whatever it was isn’t a problem anymore. 

To help with the grunt work that testing sometimes is, Python comes 
with a handy built-in module called unittest. This modulet sole 
purpose in life is to allow you to write code that testsyour code. Trust us, 
this isn’t as strange as it sounds. The unittest module provides 
a framework within which you can exercise your code to ensure it’s 
working the way you want it to. 

The idea is simple enough: as you write your code, you write a 
little extra bit of code based on unittest to check that your new 
code is working properly. If the test works (that is, it successfully 
demonstrates that your code is OK), you are then in a position to 
automate the testing of your code by reusing your unittest code. 

For more details, check out the description of unittest in your 
favorite Python book or Online in the official Python documentation. 

And now that you know about unittest, you have no excuse not 
to use it to test your code. 
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exterminating bugs 


* 5 : Pebuggiwg 

This is not as disgusting as it sounds. 

Debugging is related to testing. It is the process of dealing with 
errors that aren’t picked up during testing but, instead, blow up in 
your face when you run your code or—worse—blow up in the face 
of your user! 

Tracking down where a problem is can sometimes feel like a bit of 
an art form, but there are some tried and true techniques that can 
make things easier for you. Experience helps a lot. 



O 

0 



One of the most important things you can know about when it 
comes to debugging code is a thing called the debugger. This is 
a Software tool that can be used by programmers to run code step 
by step or line by line. As the program runs, the debugger lets you 
watch what’s going on and then potentially see when something 
goes wrong. If you can work out where in your code the problem lies, 
it makes it easier to fix, and the debugger is designed to help you do 
just that. 

It is a rare programming technology indeed that comes without 
a debugger. Python’s is called pdb and it can be accessed from 
within IDLE and within the Python Shell. Gheck the Python online 
documentation for more information on pdb. 


As mentioned at the top of the page: debugging is related to testing. 
Typically, you debug your code after it is up and running and 
(possibly) delivered to your user. You test your code as you write it 
and before you give your program to your users. The idea is that you 
only ever give a user your program when you’re happy it works the 
way you want it to. 


To be honest, though, there are no hard and fast rules here, and a 
lot of programmers blur the line between debugging and testing, 
treating it all as one activity. 
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#6: CowwawHme execotiow 

Throughout the IOV 2 chapters of this book, youVe consistently 
executed your code from within the IDLE programming 
environment. This has been great while developing and working 
on your code, but it’s probably not how you want your users to run 
your programs. It turns out there’s more than one way to do it 
when it comes to running your code. The method available to you 
(and your users) will vary depending on the operating system you’re 
using. 

Your operating system might have a file association already in place 
that allows you to double-click on a Python program and have 
it execute for you. If this is the case, feel free to double-click to 
your heart’s content. If not, here’s how to start Python from the 
command line on the “big 3” operating Systems. Let’s assume the 
program you’re running is called cof f ee_pos . py: 



On Windows, en-tev -the 
u C : \Py-thor3l \pyihcm 

-fcoge-ther y/iih ihc 
name o( -the pvogvam you 
wdn{. *to e*e£u-te. 


File Edit Window Help Mac OS X and Linux 


$ python3 coffee_pos.py 


1. DONUT 

2. LATTE 

3. FILTER 

4. MUFFIN 

5. Quit 


Choose an option: Jj 





YIU/" - 

m os L "' 
‘ mC 
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down with oop 


* 7 : Ooops... we couIdVe covered more OOP 


Chapter 10 introduced the important concept of classes , and throughout 
the book weVe touched on objects in lots of different places. Doing justice 
to all the concepts of object orientedprogramming (OOP) would easily take 
an entire book all on its own. 


The bit of OOP covered in Chapter 10 relates to the concept of 
encapsulation. This is the process of bundling data with methods into 
prebuilt templates that can be used to create functionally identical objects of a 
certain type. 


Now... if your eyes glazed over reading that last line, don’t worry; you are 
as normal as the rest of us. OOP is full of terminology like this. As well 
as encapsulation, there’s inheritance and polymorphism, too. 

Discussing all the ins and outs of OOP is something that takes a little 
time and it is not something that we are going to try and do on just one 
page! 

That said, OOP really comes into its own when your programs get very 
large and turn into Software Systems. When Systems start to scale 
(get really, really big), the importance of proper design takes center stage, 
and OOP can help here—big time. Again, there’s help from those lovely 
people at Head First Labs. 



This book assumes you alveady 
know a little bit about Java, 
so toKsidev- \readm 5 Head 
First Java -fivst. 
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#8: Algorithms 

There are plenty of great books that believe it’s impossible to learn 
about programming without also learning about algorithms. 

The word “algorithm” is used to describe a precise and established 
way of solving a particular problem in any programming language. 
It’s often useful to think of an algorithm as a recipe. 

In the good of days, it was certainly true that every programmer had 
to have a good grasp of algorithms in order to get anything of any 
worth done. But, luckily for you, this is no longer the case. 

Nowadays, with programming technologies such as Python (and 
Ruby, Perl, Java, and C#), this is less of an issue because modera 
programming languages just do so much for you. 

For instance, if you need to sort something in Python, you either 
call the sort () method on a object or use the built-in sorted () 
function, and the thing you are working with is duly sorted. You are 
probably less concerned (and rightly so) with how the sort actually 
occurred —that is, with the details of the algorithm used to sort your 
data. Was it the quicksort algorithm or the bubblesort ? Maybe it was 
timsort or something else entirely? Maybe you don’t care, because 
calling sort () or using sorted () orders your data in the way you 
desire and frees you to move onto some other problem that needs 
solving. 

You could take the time to write a really cool sort function and learn 
lots about algorithms in the process but, let’s face it, life is far too short. 

If you want to write your own programming language, you’11 need 
to learn lots about algorithms. If all you want to do is use an existing 
programming language (like Python), you can worry less about 
algorithms and more about writing code, which is precisely how it 
should be (in our opinion). 
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heavy lifting 


„ , Scarv 

*9: Advawow t programwing topics 

There are a bunch of advanced programming topics that were never likely to 
make it into a book like this. Here is a list of six such topics (all supported by 
Python 3). 

Threads are a programming technology that allows you to break your 
program into discrete coded chunks that can then be executed in parallel or 
concurrently. Each chunk is known as a thread. Using threads can resuit in 
some beautiful coding designs, which can make the solving of a certain class 
of problem almost trivial. Under certain circumstances and restrictions, it is 
possible to have threads communicate with each other and share data, which, 
although possible, is hard to get right and can lead to some rather tricky 
and hard-to-track-down bugs. If you think you need threads, approach with 
extreme caution and be prepared to have your brain expanded in ways that you 
never thought possible. 

Recursion is a programming technique that allows you to create a function 
that is capable of calling itself in order to get its work done. There are certain 
types of mathematical problems that are well-suited to a recursive solution, 
but not much else. 

Metaprogramming refers to writing programs that can write other 
programs or manipulate themselves (sounds icky, and it can be). It is not for 
the faint of heart. 

Functional programming (typified by languages such as Lisp) is a 
technique that treats computation as a series of function calls that specify 
what is required of the program, as opposed to a procedural program, which 
details the steps that are required in order to solve a problem. 

Regular expressions are a technology that allows you to specify 
concisely what it is you are looking for in your data. Having written a 
regular expression (or regex), Python can then go and get it for you. Every 
programmer should know how to take advantage of regexes. The trouble is, 
they look so very strange at first that most coders recoil in disgust. This is a 
pity, as we think regexes are super cool and well-worth learning. 

Unicode is an industry Standard that allows you to consistently represent 
and work with text written in most of the world’s languages or “writing 
Systems.” If you are working with text originating from somewhere other 
than the place where they speak your language, then you’11 want to know a 
bit about the Unicode character encoding system. 

If you find yourself needing any of this stuff, best to start on the Internet and 
do some background reading on the topic before buying a book with your 
hard-earned cash. The Wikipedia entries for each of these six topics are 
good starting points. 
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#10: Other IPE$, shells, awd text editors 

It might be hard for you to fathom, but there is life beyond IDLE. 
There’s life beyond the Python Shell, too. Both IDLE and the Python 
Shell are great learning tools, but sooner or later, you might find 
yourself wanting more. 

iPython is a bit like the Python Shell on steroids , and a lot of Python 
programmers swear by it. It has a lot of extra features over and 
above those in the normal shell that are designed to make the Python 
programmer’s life easier. It is well-worth looking into. 

When it comes to full-blown programming environments, there 
are many choices. Search the Internet for “Python IDE” to see a 
complete list. A few that come up more than most include: Komodo, 
Eclipse, and Eric. It’s worth taking a look at each, and then 
deciding if one of them (or something else entirely) is just right for 
you. 

IDLE and the Python Shell may satisfy your needs. But, if you are 
looking for more from your programming tool, there’s lots of choices 
out there. 

As for text editors... well, there are lots of choices, too. Some people 
prefer Emacs, while others prefer vi. The Head First Labs advice is to 
try out a few editors before picking the one that best suitsyour needs. 
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Sytobols 

: (colon) 

in if/else branches, 22 
in index of string, 43 
in while loops, 29 

{} (curly brackets), creating hashes, 153 

= (equal sign), assignment operator, 4, 35 

== (equal sign, double), equal to operator, 4, 15 

!= (exclamation point, equal sign), not equal to operator, 
30 

0 (parentheses) 

in format strings, 182 
in function definition, 82 

% (percentage Symbol), preceding format strings, 180-182 

. (period), in library function request, 69 

+ (plus sign), addition operator, 58 

# (pound sign), preceding comments, 95, 205 

> (right angle bracket), greater than operator, 62, 75 

I ] (square brackets) 

creating arrays, 132, 134 
enclosing index of array, 132 
enclosing index of string, 42 
enclosing key for hash, 153 


appendO method, arrays, 132, 144 
arguments (parameters), 96-98, 101, 111 

arrays (lists), 130-134, 144, 285 
adding items to, 138 
counting occurrences of values in, 138 
creating, 132, 134 
extending, 132, 138 
index (offset value) for, 132 
methods for, 138 
multi-dimensional arrays, 152 
removing items from, 138 
reversing order of, 138, 140 
searching, 138 
sorting, 136—140, 144 

askokcancel message boxes, 306 
askquestion message boxes, 306 
askretrycancel message boxes, 306 
askyesnocancel message boxes, 304, 306 
assignment 

of multiple values, 122—124 
of single values, 4, 35 

assignment operator (=), 4, 35 

associative arrays. (see hashes) 

automated testing, 389 


A 

abstraction, 93 
addition operator (+), 58 
algorithms, 393 


B 

Bates, Bert (Head First Java), 388 
Beighley, Lynn (Head First SQL), 170 
bloated code, 81 
books 
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Head First C# (Stellman, Greene), 388 
Head First Java (Sierra, Bates), 388 
Head First Object-Oriented Analysis & Design 
(McLaughlin, Pollice, West), 392 
Head First SQL (Beighley), 170 
Learning Python, 4th Edition (Lutz), 386 

brackets, curly ({}), creating hashes, 153, 175 

brackets, square ([]) 

creating arrays, 132, 134 
enclosing index of array, 132 
enclosing index of string, 42 
enclosing key for hash, 153 

branches, 14, 15-21, 24 

break statement, 255 

Button0 widget, 255 

connecting code to, 239-244, 245 
creating, 234-236 


c 

C# language 

compared to Python, 9 
learning, 388 

characters. (see strings) 

CheckbuttonQ widget, 331—335, 348 

classes, 366, 372-373, 383. (see also methods; objects) 
constructors for, 370—373, 383 
data for, 372 
dehning, 367-368 

clockQ function, time library, 70 
closeQ method, hies, 116, 144 
code 

bloated, 81 


command-line execution of, 391 
comments in, 95, 205 
debugging, 390 
duplicating, 80-81 
indents in, 21, 22 
paths in, 13, 20-21 
pseudo-code, 127 
Python practices for, 386 
reusing with functions, 81—82, 351—360 
reusing with modules, 192-199, 200-202, 205-211, 
214 

running from IDLE, 7—8 
saving, 7 
testing, 389 
white space in, 22 

code examples. (see examples) 

coffee examples. (see health club example; Starbuzz Coffee 
example) 

collectiori variables. (see data structures) 
colon (:) 

in if/else branches, 22 
in index of string, 43 
in while loops, 29 

combo boxes, 248 

command-line execution, 391 

comments, 95, 205 

conditionals, 35 

in branches, 14—15 
in while loops, 29 

constructors (initializer methods), 370-373, 383 

control variables, 278 

controller, 277, 292 

count() method, arrays, 138 

crashes, 296 

curly brackets ({}), creating hashes, 153, 175 
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D 

data entry widgets 

Checkbutton0 widget, 331—335, 348 
EntryQ widget, 261—262, 266—267, 269, 292 
model for, 276-278, 285, 292 
OptionMenuQ widget, 284—290, 292 
populating dynamically, 288-290, 292 
RadioButtonQ widget, 272-273, 275-280, 292 
restricting input to, 271-273 
ScaleQ widget, 336—338, 340—345, 348 
Text() widget, 261, 263, 266-267, 269, 292 

data storage, 129-130 

data structures, 131, 150. (see also arrays; hashes) 
list of, 152 

returning from functions, 164—167 
database, 170-172, 175 
datatypes, converting, 4, 9, 64-65, 75 
date and time functions, 68-73 
daylightQ function, time library, 70 
debugging, 390 
decision points. (see branches) 
decode() method, 49 
def keyword, 82, 111 

delete() method, data entry widgets, 262, 263, 267, 269 

delivery company example, 258-291 
dynamic depot options for, 283-291 
errors in delivery tracking, handling, 294—310 
GUI for delivery system, 258—268 
user input, controlling, 271-281 

destroyO method, apps, 326, 348 
dialog boxes, 248. (see also message boxes) 
dictionaries. (see hashes) 
directories, reading hies in, 378-381 
disk storage, 129 


DJ example. (see mixing Software example) 

Don’t Repeat Yourself (DRY), 88 

DoubleVarQ variable, 340, 345, 348 

drop down lists, 248. (see also OptionMenuQ widget) 

DRY (Don’t Repeat Yourself), 88 


E 

Eclipse IDE, 395 

editors, 5, 395. (see also IDLE) 

Emacs editor, 395 

encapsulation, 392 

endswithQ method, strings, 56 

EntryO widget, 261, 269, 292 
creating, 266-267 
methods for, 262 

equal sign (=), assignment operator, 4 

equal sign, double (==), equal to operator, 4, 15 

Eric IDE, 395 

errors, 311. (see also debugging; testing) 
crashes resulting from, 296 
displayed in Shell instead of GUI, 295 
displaying in message boxes, 303-309 
exceptions, 296—300, 311 
TypeError message, 63-64 
ValueError message, 119-120 

event loop, 233-234, 255 
events 

handlers for, 239, 244-245, 255 
from operating system, 319, 348 
from Window Manager, 319-324, 326-327 

example s 

delivery company example, 258-291 
game show example, 216-254 
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guessing game, 3-34 

health club example, 17 8-213 

mixing Software example, 314—347, 350—382 

Starbuzz Goffee, 38—74, 78—110 

storeroom example, 294—310 

Surf-A-Thon example, 114—143, 146—174 

except statement, 298-300, 311 

exceptions, 296—300, 311 

exclamation point, equal sign (!=), not equal to operator, 
30 

extendi} method, arrays, 138 


F 

false value, 14 
File menu 

New Window option, 6 
Save option, 7 

files 

handles for, 116 

permissions for, 295 

reading ali files in directory, 378-381 

readingfrom, 116—118, 166 

findO method, strings, 56-58 

floatO function, 64—65, 118 

for loop, 116—118, 154—156 

format strings, 180-184, 186, 214 

formatted data, 179 

FQNs (fully qualified names), 207-211, 213, 214 
FrameO widget, 364, 373, 383 
fully qualified names (FQNs), 207—211, 213, 214 
functional programming, 394 

functions, 82. (see also reusing code; specific functions) 
calling, 82, 84 


creating (defining), 82, 111 

local functions, 356-358, 383 

parameters for, 96-98, 101, 111 

returning data structures from, 164—167, 170—172 

returning values from, 87—88, 111 

with same name in different modules, 206-211,213 

scope of variables in, 104-108 


G 

game show example, 216-254 

answers, displaying in GUI, 246-254 
answers, sound effects for, 216-228 
answers, tallying, 216-218, 226-228 
GUI for, 230-245 

getO method 

data entry widgets, 262, 263, 269, 278 
IntVarO variable, 332, 334 

get_busyO method, channels, 221 

global variables, 108-109, 244 

gmtimeQ function, time library, 70 

graphical user interface. (see GUI) 

greater than operator (>), 62, 75 

Greene, Jennifer (Head First C#), 388 

grouping widgets, 363—364 

guessing game example, 3-34 

guesses, determining if correct, 3-8 
guesses, higher or lower hints for, 10-25 
multiple guesses, allowing, 26—34 

GUI (graphical user interface), 215, 230-232. (see also 
widgets) 

displaying messages in, 246-254, 303-309, 311 

errors not displayed in, 295 

event loop for, 233-234 

guidelines for, 341 

positioning widgets in, 235-238 
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a 

hash mark (#), preceding comments, 95, 205 

hashes (dictionaries), 152, 175 

adding data to, 153, 156, 161-162 

creating, 153, 175 

iterating through data, 154-156 

keys of, restrictions on, 156 

returning from functions, 164—167, 170—172 

sorting, 158 

Head First C# (Stellman, Greene), 388 

Head First Java (Sierra, Bates), 388 

Head First Object-Oriented Analysis & Design 
(McLaughlin, Pollice, West), 392 

Head First SQL (Beighley), 170 

health club example, 17 8-213 
file format changes, 187—199 
multiple price discounts, 204-213 
price discount, 200-203 
transactions, recording in file, 179-186 

Help menu, 22 

HTML, as strings, 49 


i 

IDE (Integrated Development Environment), 5, 9, 395 
IDLE, 5, 9, 22 

if/else branches, 4, 15-21, 24 
import statement, 49, 69 
importing 

libraries, 49, 69, 221, 226 
modules, 193, 199, 202, 211, 214 

indents in code, 21, 22 


index (offset value) 
for arrays, 132 
for strings, 42 

index0 method, arrays, 138 
inheritance, 392 

_init_0 method, 372, 375, 383 

initializer methods (constructors), 370-373, 383 
input0 function, 4, 35, 387 

insert0 method 
arrays, 138 

data entry widgets, 262, 263, 269 
int0 function, 4, 9, 35 

Integrated Development Environment (IDE), 5, 9, 395 
internationalization, format strings for, 186 
interpreter, 5. (see also IDLE) 

IntVar0 variable, 249, 253, 255 
iPython shell, 395 
IronPython project, 388 
items0 method, hashes, 154, 175 
iteration. (see loops) 

J 

Java language 

compared to Python, 9 
learning, 388 

Jython project, 388 

K 

keys0 method, hashes, 154, 175 
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key-value lists. (see hashes) 

Komodo IDE, 395 

L 

Label() widget, 248-253, 255 
labeis for values. (see variables) 

Learning Python, 4th Edition (Lutz), 386 

libraries, 75. (see also pygame library) 
importing, 49, 69, 221, 226 
third-party libraries (packages), 220, 223 
time library, 68—73 

tkinter library, 233-236, 238, 255, 341 
linked lists, 152 
listdirO function, 380 
lists. [see arrays) 
local functions, 356-358, 383 
local variables, 105, 106, 111 
localtimeO function, time library, 70 
loops, 28, 35 

delaying iterations of, 67-73 
event loop, 233-234, 255 
for loop, 116—118, 154—156 
while loop, 29—33, 61—65 

lower0 method, strings, 56 

Lutz, Mark (Learning Python, 4th Edition), 386 


McLaughlin, Brett D. (Head First Object-Oriented Analy 
sis & Design), 392 

memory, 129—130 

menus, 248 

message boxes, 303-309, 311 
messages 

error messages. (see errors) 
protocol messages, 322 
sendingto Twitter, 93—98, 101 

metaprogramming, 394 

methods, 377, 383. (see also specihc methods) 
calling, 369-372 
dehning, 367-368 

mixing Software example, 314—347, 350—382 
multiple tracks, controlling, 350-376 
multiple tracks, reading from directory, 378-382 
toggle for starting and stopping, 328-335 
tracks, starting and stopping, 314-327 
volume control, 336—347 

model for data entry widgets, 276-278, 285, 292 

Model View Controller (MVG), 277 

modular code, 192-199, 200-202, 205-211, 214. (see also 
reusing code) 

module, (see code) 

multi-dimensional arrays, 152 

multiple assignment, 122-124 

MVG (Model View Controller), 277 


M 

mainloopO method, tkinter, 234, 253 
mappings. (see hashes) 


N 

\n, newline in format strings, 182 
New Window option, File menu, 6 
not equal to operator (!=), 30 
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o 

object API, 292 

object-oriented languages, 368, 383 

object-oriented programming (OOP), 392 

objects, 366, 368, 377, 383. (see also classes; methods) 

offset value (index) of strings, 42 

OOP (object-oriented programming), 392 

openQ function, 116, 144 

OptionMenuO widget, 284-290, 292 

Options menu, 22 

ordered lists. (see also sorting data) 

P 

packQ method, tkinter, 235-236, 238, 264, 269 

packages (third-party libraries), 220, 223 

parameters for functions, 96-98, 101, 111 

parentheses (0) 

in format strings, 182 
in function definition, 82 

pass statement, 221, 255 
paths in code, 13, 20-21 
pdb debugger, 390 

percentage Symbol (%), preceding format strings, 180-182 

period (.), in library function request, 69 

permissions for files, 295 

playO method, sounds, 221 

plus sign (+), addition operator, 58 

point-of-sale (POS) system, 178. (see also health club 
example) 


Pollice, Gary (Head First Object-Oriented Analysis & 
Design), 392 

polymorphism, 392 

popO method, arrays, 138 

POS (point-of-sale) system, 178. (see also health club 
example) 

pound sign (#), preceding comments, 95, 205 

print() function, 4, 35, 387 

program. (see code) 

programming idioms, 386 

protocol events, 321-322 

protocol() method, apps, 322 

pseudo-code, 127 

.py hle extension, 7 

pygame library, 219-223, 229, 255 
downloading and installing, 220 
importing, 221, 226 
mixer object for, 221, 226 
platforms supported by, 219 
setting volume, 339 

Python, 9 

books about, 386 
command-line execution of, 391 
compared to Java and G#, 9 
integrated into other languages, 388 
programming idioms for, 386 
Systems supporting, 9 
version 2 of, 387 
versions of, 9 

Python IDE. (see IDLE) 

Python Shell, 5 

errors displayed in, 295 
running code in, 8 

.pyw hle extension, 237 
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Q. 

queues, 152 


R 

RadioButtonO widget, 272-273, 275-280, 292 

randintO function, 33, 35 

raw_input() function, 387 

readO method, 49 

reading from files, 116—118 

record, 179. {see also database) 

recursion, 394 

regex, 394 

Regional Surfing Association (RSA) example, 160—167 

regular expressions, 394 

remove() method, arrays, 138 

repeating pieces of code. (see loops) 

replace() method, strings, 56 

reserved words, 341, 348 

returnO statement, 87-88, 111 

retura values for functions, 87—88, 111 

reusing code. {see also functions) 
with functions, 81—82, 351—360 
with modules, 192-199, 200-202, 205-211, 214 

reverse() method, arrays, 138, 140, 144 
right angle bracket (>), greater than operator, 62, 75 
RSA (Regional Surfing Association) example, 160-167 
Run Module option, Run menu, 7 


S 

Save option, File menu, 7 

ScaleQ widget, 336—338, 340—345, 348 

scope of variables, 104-108, 111 

searching 

arrays, 138 
strings, 52-58 

self variable, 369—370, 377, 383 
set() method 

data entry widgets, 278, 280 
IntVarQ variable, 249 
set_volume() method, pygame, 339 
sets, 152 

sharing code. {see reusing code) 

Shell, {see Python Shell) 
showerror message boxes, 306, 308 
showinfo message boxes, 304, 306 
showwarning message boxes, 306 
Sierra, Kathy (Head First Java), 388 
sleepO function, time library, 70, 72-73 
slider on a scale. {see Scale() widget) 
sort() method, arrays, 138, 144 
sorted() function, 158, 175 

sorting data, 128-129 
algorithms for, 393 
in any data structure, 158, 175 
in arrays, 136—140, 144 

sound 

pausing between playing, 221, 223 
playing, 221, 226-227 
pygame library for, 219-223, 229 
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starting and stopping, 316-317 
volume, adjusting, 336—345 
WAV files for, 221, 223 

source code. (see code) 
spaces. (see white space) 

splitQ method, strings, 121-124, 144, 161-162, 175 
SQL, 170. (see also database) 

square brackets ([]) 

creating arrays, 132, 134 
enclosing index of array, 132 
enclosing index of string, 42 
enclosing key for hash, 153 

stack, 104 

stack frame, 105, 111 

Starbuzz Coffee example, 38—74, 78—110 
coffee supplies, maintaining, 78-91 
discount price, finding in HTML, 50—59 
health club discounts, calculating, 204—213 
low price, checking for, 60—74 
order messages, sending to Twitter, 92-110 
price, extracting from HTML, 38—49 

startswith() method, strings, 56 
Stellman, Andrew (Head First C#), 388 
storage of data, 129-130 
storeroom example, 294—310 

strings, 41-42, 48, 75 

ending substring, checking, 56 
formatting, 180—184, 186, 214 
lowercase, converting to, 56 
methods for, 55-56 
offset value (index) of, 42 
removing white space from, 56 
replacing substrings in, 56 
searching for substrings in, 52-58 
splitting at spaces, 121-124 
splitting at specified character, 161-162 


starting substring, checking, 56 
substrings of, 43-46, 48, 49 
uppercase, converting to, 54, 56 
web pages as, 49 

StringVarQ variable, 278, 280, 292 

stripQ method, strings, 56 

substrings, 48 
length of, 49 

searching for, in strings, 52—58 
specifying, 43-46, 49 

Surf-A-Thon example, 114—143, 146—174 
highest score, calculating, 114-125 
names, matching to scores, 142-143, 146-157 
score data, extracting from database, 169-174 
score data, extracting from formatted file, 160-167 
scores, sorting, 136-141, 158-159 
three highest scores, calculating, 126-135 

T 

tabs in code, 22 
testing, automated, 389 
text. (see strings) 
text boxes, 248 

TextQ widget, 261, 269, 292 
creating, 266-267 
methods for, 263 

third-party libraries (packages), 220, 223 
threads, 394 

timeQ function, time library, 70 
time library, 68-73 
timezoneQ function, time library, 70 
TkQ app, 234, 255 
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tkinter library, 233-236, 238, 255, 341 
toggle switch. (see GheckbuttonO widget) 
transaction file, 179-184, 188-191 
true value, 14 

try statement, 298—300, 311 

TVN example, 169—174. (see also game show example) 
Twitter, sending messages to, 93-98, 101 
TypeError message, 63-64 
types. (see datatypes) 

u 

Unicode character encoding system, 394 
unittest module, 389 
upper0 method, strings, 54, 56 
uppercase, converting strings to, 54 
urllib.request library, 69 
urlopenQ function, 49 

V 

ValueError message, 119-120 
variables, 4, 35 

collections of. (see data structures) 
control variables, 278 
global variables, 108-109, 244 
local variables, 105, 106, 111 
scope of, 104-108, 111 

vi editor, 395 


view, 277. (see also widgets) 

visual toggle. (see CheckbuttonQ widget) 

volume, adjusting, 336—345 

w 

wait_finishQ function, 221, 223 
WAV files, 221, 223 
web pages, as strings, 49 

West, Dave (Head First Object-Oriented Analysis 
Design), 392 

while loop, 29—33, 61—65 

white space 
in code, 22 

removing from strings, 56 
specifying in format strings, 182 
splitting strings at, 121-124 

widgets 

ButtonQ widget, 234-236, 239-244, 245, 255 

choosing, 341 

compared to objects, 368 

for data entry. (see data entry widgets) 

event loop for, 255 

FrameQ widget, 364, 373, 383 

grouping, 363—364 

Label() widget, 248-253, 255 

list of, 248 

positioning, 235-238 
Window Manager, 348 
Window Manager events, 319-324, 326-327 
WM_DELETE_WINDOW message, 322 
WM_SAVE_YOURSELF message, 322 
WM_TAKE_FOCUS message, 322 
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